The Custom HTML widget has a wide range of uses. CivicEngage is a powerful platform that gives you the ability to consume its Application Programming Interfaces (APIs) or integrate your own web services. This functionality allows our web solution to be used for many different needs. A few examples that our customers have integrated with our website are Property Tax Calculators, Inmate Lookup Tools, Parcel Searches, and many custom web service integrations. The most popular are:
- YouTube Video Embeds
- Vimeo Video Embeds
- Other Video Embeds
- Iframes
- Custom Script
- Video Tour books
Many applications offer an API, which allows other applications to interact with their system. A CivicEngage site can also interact with almost any API available using a Custom HTML widget. APIs also have the ability to receive data from CivicEngage. To do this, you will POST a request to an endpoint that contains data in a format the API is expecting.
Important Notes
- If you need assistance or have questions, please contact Support. However, if the Custom HTML script has been provided by a party other than CivicPlus, Support will only be able to assess the interaction of the code with the CMS. Support is unable to troubleshoot third-party code beyond basic analysis.
- In the event that Custom HTML code conflicts with a page, you may need to Disable Custom HTML Rendering to access editing options.
- Some links or content may not operate via iFrame based on browser or security policies. Please view our article Embed Videos on a Page for further troubleshooting options.
- The Custom HTML widget will only accept URLs that have a valid Secure Sockets Layer (SSL) Certificate. HTTPS://
Disclaimer
Not all code is compatible with the CivicPlus Content Management System (CMS). Conflicts between an added script and our base system code can cause pages to break. This can include widgets not behaving as expected, editing functions becoming disabled, or a complete lack of access to the page. Due to these potential errors, it is recommended that Custom HTML be tested on copied pages prior to being added to a live page or the full site. Future releases may impact compatibility, which may cause previously working code to fail.
Instructions
Who can use this feature?
- Navigate to your desired page
- Ensure Live Edit Is On
- Select Widgets from the tab menu
- Drag and drop the Custom HTML widget onto the page where you would like your item to show
- Paste your custom code into the widget
- Select Done
- Click Save
Note: You may not be able to see the product of your code in live edit. You may have to turn live edit off before being able to see what a user will see.
Feedback About the Article
Let us know what was helpful or not helpful about the article below.3 comments
Can we please add a list (at the top of the page) of what languages/scripts are accepted inside the widget?
It should be noted that only secure website links (https://) are allowed.
Hello Ken!
Thank you for bringing this to our attention. We have added that information in this article as an Important Note.
We appreciate your feedback!
Please sign in to leave a comment.