Advanced Techniques

Here are some tips on how to “hack” #SoundOff to further customize your campaigns. If you have questions or would like assistance, feel free to email us at [email protected]

1) Skip a step when sending users to your campaign:

Your campaign URL links to your #SoundOff campaign description, where users click a button to get started, and then enter their ZIP. If you want to skip a step and have users enter their zip code right away, Just add “?zip=” to the end of the URL that you send to your supporters.

For example, click on both of these and decide which you prefer:

The second version is useful when you’ve already told your supporters what your campaign is about and asked them to tweet at Congress.

2) Track supporters’ actions without asking for their email addresses:

What if you want to know which current supporters are taking action, but you don’t want to ask for email addresses? If you are emailing your campaign link to supporters and have the ability to add a variable and pass supporter information to the URL, just place their email address at the end of the URL.

Like this:[email protected]

Your supporter won’t be asked to provide an email address, and their email address will not be shared with HeadCount. But, their email address will still show up next to their action in the user data “Download Names” CSV file. You can then upload that to your database and know they took action. In this case, the supporter will not be asked to opt in or out of anyone’s email list (yours or ours) and only you will have this data.

3) Use your own graphics, and have the #SoundOff module pop up on your web page:

The two basic ways to run a #SoundOff campaign are to have supporters click on a link to your Campaign URL, or embed your campaign widget on your web page. But what if you have a certain graphic look you want to maintain, and don’t want traffic to leave your page? There’s a way to make the #SoundOff module pop up directly on your site. If you know a bit about coding, this Example Code shows you an example of how this worked with a previous campaign. For more information on further customization, please get in touch with us at [email protected] .

4) Take your supporters right to a pre-filled tweet (that contains your hashtag and first suggested tweet):

It's simple to take your supporters to a tweet that's ready to send. Just insert the phrase "direct" in your campaign URL before your campaign extension.


This is most useful when you want all the tweets to carry the same message, or cut down on the steps required for the user. Note that the user will still need to enter their ZIP before they are taken to Twitter and their pre-filled tweet. And there will be no language about the campaign, so you’ll need to include an explanation via email or social media along with the link.

5) Target a specific Rep or Senator:

Add a ZIP code in your targets district to the end of the campaign URL, like this:

To target anyone else, use a zip that is entirely in their district. Also make sure that your campaign is set to House or Senate, depending on who you want to target. We RECOMMEND that when using this technique, you also use the “direct” function, like this:

This will take the user directly to a pre-filled tweet targeting a particular legislator.

NOTE: Many zip codes are in more than one congressional district. Be sure the zip code you select is exclusively in one district.

Built by Scott Duncombe & designed by Bryan Chiem
SoundOff utilizes The Sunlight Foundation’s Congress API.