Buttondown Documentation
Whether you’ve got a casual question ("What’s your favorite Star Wars movie?") or a debate that needs settling ("Who shot first: Han Solo or Greedo?"), Buttondown’s "Surveys" feature is a nifty way to get feedback from your subscriber base. Read on to discover how to create, send, and analyze surveys—and learn valuable insights about your subscribers along the way!
Venture to the "Surveys" tab of your newsletter and click "New." You’ll encounter a pop-up that will guide you through the process of creating your survey. Your first task? Coming up with a question to ask your subscribers.
Each survey has room for one question and one question only, so make it count! However, you can always include multiple surveys in a single email if you have more than one question to ask.
Next up, devise an ID for your survey in the "Code" field using letters (A–Z) and numbers (0–9). Your subscribers won't see this code—it's just for your internal use—but we recommend making it identifiable so that you can retrieve and render your survey more easily.
The "Answers" field is where any and all possible survey responses should go. List out each of your responses (e.g. "R2-D2," "C-3PO," and "BB-8") on separate lines without any punctuation. Buttondown will take care of the formatting for you!
Get a sneak peek of your survey in the "Preview" section.
This is also a good opportunity to glance back at your "Question," "Code," and "Answer" fields, as once you publish your survey, these fields can’t be changed.
Down the line, if you’d like to make an adjustment to your survey, feel free to contact our support team for assistance. However, whether your changes are big or small, the best way to edit your survey will be to create a new survey from scratch.
At this point, your preview’s looking good and you’re ready to publish your survey. Before clicking "Create," take a moment to copy your survey’s code in the "Usage" section. You’ll need this code to render your survey in your email.
Each survey’s code will always follow the same format. Here’s a quick example:
In this case, "ID" refers to the text you used to populate your survey's "Code" field. Here’s a more "real world" example:
Once you’ve copied your code, all that’s left to do is to click "Create"! In just a few moments, your survey will be published and ready to share with your subscribers.
You’ve drafted up your email and now all it needs is the cherry on top: Your survey!
Here’s where that code you copied from the "Usage" section will come in handy. Simply paste the code where you’d like your survey to appear.
Your writing interface won't render your survey in its entirety, so we recommend sending an email draft in order to make sure your survey’s ship shape. (Need a refresher on sending email drafts? Our "Getting Started" page is the best place to go!)
Here’s what your survey might look like as part of your email draft:
Note that if you try to click through the survey in this draft email, the buttons won’t work. That’s totally normal! Your survey will only record responses from subscribers who receive your finished email. This ensures that your survey results are as accurate as possible—more on this later!
Feel free to customize the look and feel of your survey by modifying Buttondown’s basic HTML markup. Our standard styling is as follows:
Buttondown automatically assigns a "survey" div class to your code, so if you’re having trouble finding your survey in your CSS, all you have to do is search for the "survey" wrapping div! Convenient, right?
If the rest of your email is all set, that means it’s time to click "Send"! (Sending your very first email with Buttondown? Our "Getting Started" guide will walk you through the process.)
Here’s an example of what any given subscriber will see when they engage with your survey:
There are two things to keep in mind as you comb through your survey’s responses:
We put these measures in place to ensure that your survey responses are an accurate reflection of your subscriber base. With that in mind, let’s take a look at your survey’s results!
Toggle to the "Surveys" tab of your newsletter and click on the three dots to the far right of your survey’s ID. When the drop-down menu appears, select "Answers" to view a breakdown of your survey’s responses to date, as well as an accompanying graph.
Want to analyze your survey’s responses in more detail? We recommend exporting your survey’s data as a CSV file so that you can cross-reference it with other variables like tags, metadata, and more.
If you’re already in your newsletter’s "Surveys" tab, you can export survey data by clicking the little check mark next to your desired survey and then clicking "Export" in the upper right hand corner.
Shortly after you hit the "Export" button, you’ll be prompted to download your data.
Within a few moments, you'll have a detailed CSV file containing your subscribers’ emails and survey responses.
Looking for new ways to organize and analyze your subscriber base? Check out our guides on "Tags" and "Metadata" for ideas!