You can share some of our tools on your organization's website to increase visibility and engagement. We have sharing options for the Ideas, Places, Survey, and Quick Poll tools, and these options include:
Before You Start
Before sharing a tool on your website, each project and tool must meet the following criteria:
Project status must be Published
Survey or Quick Poll Participation settings must be Anyone can Participate, and Places must Allow unverified participation
Tool status must be Published
There are also some things to consider:
Project Visibility settings do not impact Engagement Embeds; anyone with the embed or standalone link can access the tool, regardless of whether the project is Protected.
If you have embedded or linked to a tool that is then archived or unpublished, users will see a notification that they cannot submit in place of the tool. Unpublished ideas tools will lead to an error page. You will need to remove the code or link from your site manually.
Create a Tool Landing Page
You can use the Standalone link to create a landing page for the Places, Survey, or Quick Poll tool.
To retrieve the link:
On the project page, select the tool in the tool tabs and select Share.
Select the Standalone option to see the Link.
Select Copy link and paste it wherever you want to share it.
Anyone who follows the link will go directly to the tool’s page where they can submit a contribution.
Embed a Tool
You can use an embed code or iFrame to embed the Places, Survey, or Quick Poll tools directly onto a webpage. When you embed these tools, participants can answer and submit directly on the website.
To retrieve the code:
On the project page, select the tool in the tool tabs and select Share.
Select Add to webpage for an embed code or Add iFrame for a code for websites that don’t support inline script.
Select Copy code and paste it into the required environment.
You can also use the Add to email option to embed an emoji question into the HTML of a newsletter or email, such as on a govDelivery bulletin or OpenForms notification. When the recipient chooses an emoji option, the standalone link will open in their browser, where they can complete and submit the survey.
Embed the Engagement Banner
For Places and Ideas, you can embed an engagement banner, which displays the tool description and its latest posts. Participants can select the See all button to open the tool in a new tab of their browser, where they can submit a contribution.
To retrieve the code:
On the project page, select the tool in the tool tabs and select Share.
Select Add banner to webpage for Places and Add to webpage for ideas, or Add iFrame for a code for websites that don’t support inline script.
Select Copy code and paste it into the required environment.
Troubleshooting and Tips
If you're having trouble implementing an embed code, there are various things to try:
You can test the embed code in a CMS editor to see how it will be display on your site.
Ensure the code snippet has been copied correctly and no HTML is missing.
Ensure that your embed code is compatible with EngagementHQ's supported browsers and devices.
Embeds and Reporting
Reporting on Engagement Embeds works like your usual Ideas, Places, Quick Poll, and Survey reporting. While we don't facilitate filtering by submission type, all Engagement Embeds submissions are captured in EngagementHQ reports, including Submissions Manager.
Every submission made through an Engagement Embed will count as:
No page views are counted, and each subsequent submission will count as another visit in the same manner.