# Inserting Polling Place Info

{% hint style="warning" %}
This integration will only work if two conditions are met:

**1) Polling place information needs to be available on the DNC's iwillvote.com website.** The DNC aims offer comprehensive coverage for major elections. More info about this [below](#where-does-the-data-come-from).

**2) The people you are texting have ZIP codes.** Without zip codes, the polling place lookup will not work.
{% endhint %}

### Overview

To send out polling information, you can use [variables](/help/texting/personalized-content.md) when composing your message in Step 2 of the [Campaign Creation](/help/texting/campaigns.md) process.

You can see key variables that are most commonly used are:

* **Polling Place Name:** `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].location_name }}`
* **Polling Place Address:** `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].location_name }}`
* **Polling Place Hours:** `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].dates_hours }}`.

To put it all together, below are few example messages that include variables.

### Sample Messages

**Sample Message - Election Day**

```
Hey {{ person.first_name }}, 📅 Election Day is Tuesday, November 3rd.  
  
{% if person.primary_address.dnc_will_vote and person.primary_address.dnc_will_vote.locate %}  

Here's all the info you need to vote in {{ person.primary_address.locality }}:  
  
🗳️ Your polling place is {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].location_name }}.  
  
📍 Address: {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].address_line_1 }}, {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].city }}, {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].state_code }} {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].zip }}  
  
🕒 Polls are open from {{ person.primary_address.dnc_will_vote.locate.polling_locations[0].dates_hours }}.  
  
{% else %}  
  
🗳️ Please check your polling location at https://iwillvote.com.  
{% endif %}

```

Using the code above will output a message that looks something like this:

![](https://44727351.fs1.hubspotusercontent-na1.net/hubfs/44727351/image-png-4.png)

### **Sample Message - Early Vote**

```
Hey {{ person.first_name }}, Election Day is Tuesday, November 3rd, but you might be able to vote early!
{% if person.primary_address.dnc_will_vote and person.primary_address.dnc_will_vote.locate %}
Based on our records, here's all the info you need for early voting in {{ person.primary_address.locality }}:

🗳️ Your early voting location is {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].location_name }}.

📍 Address: {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].address_line_1 }}, {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].city }}, {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].state_code }} {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].zip }}

🕒 Early voting hours: {{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].dates_hours }}.

🗳️ Please double-check to confirm your voting info here: https://iwillvote.com
{% else %}
🗳️ You can get all the info you need to vote here: https://iwillvote.com.
{% endif %}
```

Using the code above will output a message that looks something like this:

![](https://44727351.fs1.hubspotusercontent-na1.net/hubfs/44727351/image-png-Oct-14-2024-09-29-10-7274-PM.png)

### Where Does the Data Come From?

The polling place data in Daisychain comes from the DNC's iWillVote API, which aggregates voting location information from state parties and state election authorities. Daisychain does not control when this data becomes available — it depends on when each state's data is published and loaded into the iWillVote system.

#### What to Do When Data Isn't Available Yet

It's common for polling place data to be unavailable in some states or races, especially ahead of early voting periods. This can happen even when early voting is about to start or is already underway. A few things to keep in mind:

* **State parties are the source.** The data flows from state election authorities to state parties to the DNC's iWillVote platform to Daisychain. If data is missing, the state party's data director is typically the best person to contact about when it will be available and what the plan is to get it loaded.
* **Coverage varies by race and state.** Major statewide and federal elections tend to have the best coverage. Smaller or off-cycle races may not be included at all.

#### Using Fallback Messages

Because data availability can be unpredictable, we strongly recommend using the `{% if %}` / `{% else %}` conditional blocks shown in the sample messages above. This ensures that if polling place data isn't available for a given person, they'll receive a fallback message directing them to [iwillvote.com](https://iwillvote.com) to look up their info manually, rather than receiving a broken or empty message.

### Full List of Daisychain Variables Using Info From iwillvote.com

| **Daisychain Variable**                                                                             | **Description**                                                                       |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].location_name }}`              | Name of the **Election Day** polling place.                                           |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].address_line_1 }}`             | Street address of the **Election Day** polling place.                                 |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].city }}`                       | City of the **Election Day** polling place.                                           |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].state_code }}`                 | State abbreviation of the **Election Day** polling place.                             |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].zip }}`                        | ZIP code of the **Election Day** polling place.                                       |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].dates_hours }}`                | **Election Day** polling hours.                                                       |
| `{{ person.primary_address.dnc_will_vote.locate.polling_locations[0].location_notes }}`             | Special notes about the **Election Day** polling location.                            |
| **Early Voting Locations**                                                                          | **(Below are variables for early voting locations)**                                  |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].location_name }}`           | Name of the **early voting location**.                                                |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].address_line_1 }}`          | Street address of the **early voting location**.                                      |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].city }}`                    | City of the **early voting location**.                                                |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].state_code }}`              | State abbreviation of the **early voting location**.                                  |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].zip }}`                     | ZIP code of the **early voting location**.                                            |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].dates_hours }}`             | Early voting **hours and dates** (e.g., “8:30 AM - 4:30 PM, Oct 15 - Nov 6”).         |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].location_notes }}`          | Special notes about the **early voting location** (e.g., "Park behind the building"). |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].schedule_exceptions }}`     | Exceptions to the schedule (e.g., "Closed on Sundays").                               |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].schedule[0].date }}`        | First date this early voting location is open.                                        |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].schedule[0].time_ranges }}` | Open and close times for a specific early voting date.                                |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].schedule[0].is_open }}`     | Boolean (`true`/`false`): Is this early voting location open on this date?            |
| `{{ person.primary_address.dnc_will_vote.locate.early_vote_locations[0].schedule[0].is_24h }}`      | Boolean (`true`/`false`): Is this early voting location open **24 hours**?            |
| **Ballot Drop-Off Locations**                                                                       | **(Below are variables for drop-off locations)**                                      |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].location_name }}`             | Name of the **ballot drop-off location**.                                             |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].address_line_1 }}`            | Street address of the **ballot drop-off location**.                                   |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].city }}`                      | City of the **ballot drop-off location**.                                             |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].state_code }}`                | State abbreviation of the **ballot drop-off location**.                               |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].zip }}`                       | ZIP code of the **ballot drop-off location**.                                         |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].dates_hours }}`               | Ballot drop-off **hours and dates** (e.g., “24/7 from Oct 15 - Nov 6”).               |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].schedule_exceptions }}`       | Exceptions to the drop-off schedule (e.g., "Closed on Sundays").                      |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].open_early_voting }}`         | Boolean (`true`/`false`): Is this location open **during early voting**?              |
| `{{ person.primary_address.dnc_will_vote.locate.drop_off_locations[0].open_election_day }}`         | Boolean (`true`/`false`): Is this location open **on Election Day**?                  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://daisychain.gitbook.io/help/texting/personalized-content/inserting-polling-place-info.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.