Reader polls are available on the Voyager and Luna plans. They aren’t available on the Space Station plan, and you’ll see a message directing you to upgrade if your site is on it.
Creating a poll
Go to Reader polls (beta) under Labs in the left navigation and click Create poll.
Every save shows you a preview of the poll on your site and in the newsletter before it goes ahead. A new poll can be saved as a draft or saved and opened.
Opening, closing, and archiving
A poll is a draft, open, closed, or archived. Use Open poll, Close poll, Reopen, and Archive at the top of the poll’s page to move it along. A poll with a close date closes itself when that date passes. Once a poll is open, its question and options can’t be changed, so that every vote answers the same question. Everything else can be edited. When you archive a poll, it no longer shows on the site. Its results stay in Outpost.Choosing who sees results
Who sees the results on each poll decides when readers see the results: After they vote (the default), Always, After the poll closes, or Only you. You always see the full results in Outpost.Adding a poll to a post
Open the poll and use the Add to a post panel:- Insert into a new post creates a draft post in Ghost with the poll in it and opens it in the Ghost editor.
- Copy HTML copies the poll so you can paste it into an HTML card in any post.
Polls on your site need the Outpost script, the same script every Outpost CTA needs. If your site already shows Outpost CTAs, you have it.
How readers vote
On your site, Outpost replaces the pasted poll with the live one, centered in the post. While the poll loads, faint bars about the poll’s height fill its space, so the post doesn’t jump when the poll appears. The bars pulse gently, and stay still for readers whose device is set to reduce motion. If the poll can’t be shown, for example because you’ve archived it, the placeholder is removed and the space closes up. A signed-in member chooses an option and clicks Vote. A signed-out reader is asked to sign in or sign up first. Each member gets one vote per poll, and can change it if you allow that. The sign-in and sign-up links on a poll open Ghost Portal. If you’ve turned off Use Ghost Portal for membership features on Publication Details, they go to the Sign In and Sign Up links you saved there instead. The Sign in button on the newsletter vote page, shown when the page can’t tell who the reader is, follows the same setting. Polls don’t use the sign-in URL settings in the CTA Library. In a Ghost newsletter, clicking an option opens a page that records the vote and shows the results, if your settings allow it. For a multiple-choice poll, the page lets the reader tick more options before confirming. The newsletter’s answer buttons don’t appear on your site. If a reader opens a newsletter vote link outside the email, such as from your website or an RSS feed, Outpost sends them to the post to vote there when it knows which post the poll is in. Otherwise, a page asks them to open the poll on your site. A member’s vote counts once, whether they vote on your site or from the newsletter.Results
Once a poll is open, its page shows a Results card with each option’s share, where the votes came from, and who voted for what, unless the poll is anonymous. In the Placement column, which shows where the votes came from, post names link the same way as in the Add to a post panel. Each vote also appears on the member’s activity and in the Activity Log, except in anonymous polls. The daily and weekly report emails show the current or final result of each poll that got votes during the period, closed during it, or closes in the following seven days.Poll settings
Click Settings on the Reader polls page to set the defaults every new poll starts with, and to change the text readers see on your polls, such as the vote button and the thank-you message. Leave a message empty to use the default in your site’s language.Styling polls
To change how polls look, edit the Reader Poll design in the CTA Library. It sets the colors and corner radius for every poll on your site, in the newsletter, and on the newsletter vote page. It never appears in a CTA slot on its own. Without it, polls use your site’s default CTA design. The Reader Poll design is available on sites using the new CTA system. If your site isn’t on it yet, the Reader polls page says so, and polls use your site’s default CTA colors. Email support@outpost.pub and we’ll turn on the new CTA system for your site. In the results, the empty part of each bar is a light tint of your text color over the poll’s background. The filled part uses your button background color, darkened or lightened where needed so it stands out from the empty part and the background, or your text color when no shade of it stands out enough. The check mark beside the reader’s own answer uses the same color as the filled bar.Things to know
- The newsletter block doesn’t update after you paste it. If you change the poll’s headline, intro, or design, copy the HTML again and replace the old block before the newsletter is sent.
- The HTML you copy records how many answers the poll has, so the loading placeholder on your site matches the poll’s height. If a pasted block shows a standard-sized placeholder instead, copy the HTML again and replace the block so the placeholder matches the poll. The poll works either way, and the new copy gets its own tally in the panel.
- The voting links only work in a Ghost newsletter, not in an Outpost campaign email.
- Leave the HTML card’s visibility setting in Ghost at its default. Restricting who can see the card on the web can make the newsletter answer buttons show on your site, and readers see a blank gap instead of the loading placeholder until the poll appears.
- In the newsletter, each answer is a filled button, so readers can tell it is clickable.
Related features
CTA Library
Edit the Reader Poll design that styles every poll, on sites using the new CTA system.
Events
Another Labs feature you add to posts with an HTML card.
Activity Log
See each member’s poll votes alongside their other activity.
Theme Connect Wizard
Make sure the Outpost script is on your site.
FAQ
Can readers who aren't signed in vote?
Can readers who aren't signed in vote?
No. Only signed-in members can vote. Readers who aren’t signed in are asked to sign in or sign up. The links open Ghost Portal, or the Sign In and Sign Up links on Publication Details if you’ve turned off Use Ghost Portal for membership features. Newsletter recipients are already members, so they can vote from the email.
Can I change the question after the poll opens?
Can I change the question after the poll opens?
No. The question and options are fixed once the poll opens, so that every vote answers the same question. If you need a different question, create a new poll.
Can I see who voted for what?
Can I see who voted for what?
Yes, unless the poll is anonymous. The Results card on the poll’s page lists each member and their choice.
Can I add the same poll to more than one post?
Can I add the same poll to more than one post?
Yes. Copy the HTML again for each post. Each copy is counted separately, so you can see how many votes came from each post and from the newsletter.

