Embed participation tools into other websites | Civio Engage Knowledge Base [Skip to content](#main) [ ![Civio Engage Knowledge Base](/civio-light.svg) ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io) [Product documentation](/articles) [Release notes](/releases) [Roadmap](/roadmap) [ Support portal ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) Toggle navigation [Product documentation](/articles) [Release notes](/releases) [Roadmap](/roadmap) [Support portal](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) 1. [Home](/) › 2. [Product documentation](/articles) › 3. [Participation tools](/articles?category=13) › 4. Embed participation tools into other websites Embed participation tools into other websites ============================================= Updated 5 hours ago · 4 min read Search Search 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**, **Q&A boards**, **Map feedback**, or **Budgets**. 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. ![A participation tool's embed screen open, with the Copy to clipboard button being used to copy the embed code.](https://engage.knowledge.civ.io/storage/bCgARYMmIGgocm9ofC9D7mhL62iOfAcRVxE88IXF.gif) 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. #### Why configure allowed domains? Restricting embed domains ensures that only approved websites can display your participation tools. This protects your data integrity and prevents misuse of your engagement tools on unauthorised sites. ### Global embed settings ![The Global Embed Settings page, listing the domains allowed to embed content from the site](/storage/articles/14652384511631.png) You can set allowed embed domains at the site level. These domains apply to every participation tool. 1. Navigate to **Settings** in the left-hand menu. 2. Under **Configuration**, click **Embed**. 3. Under **Global Embed Settings**, in the **Global allowed embed domains** field, add each permitted domain as its own row. Type the domain, then click **+ Add Domain** to add another. 4. Click **Save** to apply your changes. #### Domain format Enter domains without the protocol (http:// or https://), and without paths or slashes. Each domain is matched exactly: wildcards are not supported, and a subdomain is not covered by its parent domain. If your tool is embedded on both `example.com` and `www.example.com`, add both. ### Per-tool embed settings You can also configure allowed embed domains for an individual participation tool. These domains are added to the global list, not used instead of it: the tool can be embedded on any domain that appears in either list. 1. Navigate to the participation tool you want to configure. 2. Click the **ellipsis** icon and select **Embed**. 3. The embed screen opens on the **Allowed Embed Domains** card. Add each domain permitted to embed this tool as its own row, using **+ Add Domain** for each extra domain. 4. Click **Save domains** to apply your changes. This button appears once you have changed the list. ![The Allowed Embed Domains card on a survey's Embed screen, with a domain typed into the highlighted row, above the + Add Domain button and the Save domains button.](https://engage.knowledge.civ.io/storage/tlgOwbdldzwW6QNuozcsit35wPZGPc63j59sVBg6.png) The card's own note says only the domains listed there are allowed, but the site-wide list applies as well. 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](/articles/9184083413647-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](/articles/11849394390799-Participation-tool-widgets) for configuration options. #### Note Referrer data is only captured for submissions made through embedded tools. Submissions made directly on your Civio Engage site will not have referrer information. Was this article helpful? ------------------------- Your feedback helps us prioritise what to rewrite. Yes No [ Back to Participation tools ](/articles?category=13) On this page ### Still need help? Raise a request in the support portal and track it to resolution. [ Submit a support request ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) Submit a support request through the [support portal](/portal) or email . © 2026 [Civio](https://civ.io) [Privacy Policy](/articles/privacy-policy) [Terms of Use](/articles/terms-of-use)