Embed participation tools into other websites

How to embed participation tools into other websites

Participation tools can be embedded into external websites, allowing you to gather community feedback directly from other platforms. This article covers how to embed tools, configure security settings, and track where submissions originate.

Embed a participation tool

1. In the left-hand menu, click Projects.
2. Click on a project to open it.
3. In the project sub-menu, under Participation, select the type of participation tool you would like to embed: Surveys, Polls, Idea Boards, or Q&A Boards.
4. You will be presented with a list of participation tools. Select the one you would like to embed into another website.
5. On the right-hand side of the screen, click the ellipsis icon to open a dropdown menu.
6. Click Embed. You will be directed to a new screen where you have the option to Embed code.
7. Click Copy to clipboard to copy the embed code.
8. Paste the embed code where needed on your website to embed the selected participation tool.

Configure allowed embed domains

To improve security and control where your participation tools can be embedded, you can configure allowed embed domains. This prevents unauthorised websites from embedding your tools.

Global embed settings

You can set allowed embed domains at the site level, which will apply to all participation tools by default.

1. Navigate to Settings in the left-hand menu.
2. Under Configuration, click Embed.
3. In the Allowed embed domains field, enter the domains that are permitted to embed your participation tools. Enter one domain per line.
4. Click Save to apply your changes.

Per-tool embed settings

You can also configure allowed embed domains for individual participation tools, which will override the global settings for that specific tool.

1. Navigate to the participation tool you want to configure.
2. Click the ellipsis icon and select Embed.
3. In the embed settings, you will see an Allowed domains field. Enter the domains permitted to embed this specific tool, one per line.
4. Click Save to apply your changes.

Referrer URL tracking

When participation tools are embedded on external websites, Civio Engage automatically tracks the referrer URL for each submission. This data helps you understand which embedded locations are generating the most engagement.

What is tracked

For each submission made through an embedded tool, Civio Engage captures:

• Referrer Domain: The domain of the website where the submission was made (e.g., council.gov.au)
• Referrer Path: The specific page path where the tool was embedded (e.g., /community/transport-project)

Where to view referrer data

Referrer URL data is available in several locations:

• Submissions table: The Referrer Domain and Referrer Path columns appear in the submissions list for each participation tool. See View, moderate, and export participation tool submissions for more details.
• Submission exports: Referrer data is included when you export submissions to Excel.
• Reporting dashboard: Use the Submission Referrer URLs widget to visualise where embedded submissions are coming from. See Participation tool widgets for configuration options.