Embed Page Transport URLs

Embed Page Transport URLs allow users to directly access any TurboVote experience from the page embedding TurboVote on your website. They make it easier for voters to take action using TurboVote and eliminate the need to embed different TurboVote features across multiple site pages. Instead, you can maintain a single page hosting the TurboVote home page embed and use Embed Page Transport URLs to quickly direct users towards a specific TurboVote experience within the embedded hub.

This video provides a brief introduction to Embed Page Transport URLs and walks through the steps to create them. You can also read full details below.

Why are Embed Page Transport URLs helpful?

Embed Page Transport URLs help voters complete the tasks your campaign wants them to, such as checking their registration status or viewing an Election Guide.

When you embed TurboVote on your organization’s website, users can access the full functionality of the platform from a single page. Every TurboVote embed code sets a TurboVote page to show by default (e.g., your TurboVote home page). However, during your voter outreach efforts, you may want to direct users to view a specific TurboVote experience. 

Although you can create separate pages on your site dedicated to hosting specific TurboVote experiences (such as this example page embedding an Election Guide: https://planmyvote.org/election-state), it can be overwhelming for voters to navigate and requires a lot of effort to manage separate pages for different TurboVote tools.

Using an Embed Page Transport URL, users can click a link or scan a QR code to navigate directly to a specific experience within your TurboVote embed. You can even append a user’s personalization ID to a link to have the embed show them personalized content based on the information on their account. This allows your audience to access TurboVote from a centralized location on your site, while giving you the flexibility to easily promote timely TurboVote tools.

How can you create an Embed Page Transport URL?

Your TurboVote embed code sets a specific TurboVote page to display by default. The embed code’s iFrame src URL specifies the content to be embedded on your site page. Embed Page Transport URLs change this embedded content by overriding both the page path and query parameters of the default src URL. 

By appending new transport parameters to the URL hosting your site’s TurboVote embed, you can share links that direct users towards specific TurboVote experiences without changing your embed’s default settings.

Follow these steps to create an Embed Page Transport URL:

1. Step One: Go to the embedded TurboVote landing page on your organization’s website. Follow these guidelines to seamlessly embed TurboVote on your site. 

   Example: www.YOURWEBSITE.com/vote

2. Step Two: Choose the TurboVote experience you want your audience to be directed to. 

   What action do you want to help voters take?

   Such as:

   • Check their registration status
   • Register to vote
   • Request an absentee ballot
   • Sign up for election reminders
   • Prepare for an upcoming election
   • Review what's on the ballot

3. Step Three: Choose the page path applicable to the TurboVote experience you selected. A full list of TurboVote page paths is available here. Copy the relevant page path from the “Landing Page” column.

   What is a page path? A page path is the part of a TurboVote URL that defines which landing page, tool, or guide you want to embed on your website.

   For example: 

   • Upcoming elections for an address: /search/address
   • Sign-up forms, such as Election Reminders: /reminders/voter-info 
   • Election Guides: /elections/ny/2026-11-03

4. Step Four: Prefix your page path with ?tv-p= and add it to the landing page link.

   Example: www.YOURWEBSITE.com/vote?tv-p=/reminders/voter-info

   This example directs voters to sign up for TurboVote Election Reminders. The page path for Election Reminders is /reminders/voter-info.

5. Step Five: Determine your query parameters.

   What are query parameters? Query parameters define how users experience the embedded content and what data is passed along. 

   For example:

   • Override language default to show content in English: /&tv-lang=en OR Spanish: /&tv-lang=es
   • Associate users who sign up with a referral code: &tv-r=springcampaign
   • Customize a TurboVote experience for a user’s account info by appending a Personalization ID: &tv-user={personalizationId}

   Query parameters for Embed Page Transport URLs are prefixed with ?tv- if you are not updating the page path. If you are updating the path and/or appending multiple parameters, use ?tv- for the first parameter and &tv- for subsequent parameters. 

   Example: www.YOURWEBSITE.com/vote?tv-p=/reminders&tv-r=maynewsletter2026

   This example associates users who sign up for Election Reminders using this link with the “maynewsletter2026” referral code. The &tv- prefix is used because the page path was also updated.

   You can also use UTM parameters with Embed Page Transport URLs. There is no need to include the tv- prefix used for Embed Page Transport URLs on UTMs. You can combine UTMs with other parameters that require the tv- prefix. For example, the following link overrides the default referral code and adds a UTM parameter.

   Example:  www.YOURWEBSITE.com/vote?utm_source=newsletter&tv-r=launch

Embed Page Transport URL Examples

The two transport parameters (page paths and query parameters) can be used alone or in combination. This table lists several possible, non-exhaustive use cases:

Interested in learning more? Contact our team at partnerships@democracy.works for a demo and more information.