Skip to main content

BallotReady Voter Guide Partner Widget

We are excited to offer our partners this widget to inform and turn out voters!

How to use the widget:#

For easiest implementation, simply embed this code block wherever you'd like it to appear on your site.

Note: You will need to substitute out the name of your organization in data-utm-campaign = "partner-YOUR NAME"#

For Example: data-utm-campaign = "partner-coca_cola" (no spaces!)

<div class="civicengine-address" data-utm-campaign = "partner-*YOUR ORGANIZATION NAME HERE*"></div><script src="https://app.voterguide.ballotready.org/embed.js" async defer></script>

This will appear as:

Partner Widget Example

If your website building platform supports it, you may want to put the <script> line (the second line of the code) in the <head> section of your page. This will improve loading time for your page.

Including language support with the widget#

BallotReady.org can now be used in Spanish or Mandarin in addition to English. Once your users enter the voter guide through your site, they navigate to the language they prefer with any widget. However, you can also set up your widget so that they select a language when they enter their address, or provide the widget in one language by default. If you do not select a default language for the widget, users will always see whatever language they last selected on BallotReady.org, or they'll see English if they are a completely new user.

If you'd like to provide a language dropdown in the widget, you should use this code:

<div class="civicengine-address" data-utm-campaign = "partner-*YOUR ORGANIZATION NAME HERE*" data-input-locale = "yes"></div><script src="https://app.voterguide.ballotready.org/embed.js" async defer></script>

If you'd like to provide the language in a default language (English, Spanish, or Mandarin), you should include code like this:

<div class="civicengine-address"data-default-locale = "es-US-ballotready" data-utm-campaign = "partner-*YOUR ORGANIZATION NAME HERE*"></div><script src="https://app.voterguide.ballotready.org/embed.js" async defer></script>

The above code will provide the widget in Spanish to all users because it uses the language code "es-US-BallotReady." If you'd like to set a different default language, you'd use different language codes:

LanguageLanguage CodeCode example
English"en-US-ballotready"data-default-locale = "en-US-ballotready"
Spanish"es-US-ballotready"data-default-locale = "es-US-ballotready"
Mandarin"zh-US-ballotready"data-default-locale = "zh-US-ballotready"

This widget will give your audience access to BallotReady's Voter Guide and Make a Plan tools, which will allow users to research all the candidates on their ballot, and make a plan to vote in person or by mail. If you'd like to direct people specifically to making a plan to vote, you can embed this widget instead. If you'd like to connect people to BallotReady's full Election Center, follow these instructions instead.

For more information, check out our support article on the partnership widget program here. If you have more questions, feel free to contact us at https://civicengine.com/support.