Skip to main content
Reader polls let you ask your members a question inside a post or a newsletter. On your site, signed-in members vote in the post and can see the results right away or only after it closes, depending on the poll’s settings. When sent in a Ghost newsletter, each option is a link, so members can vote straight from their inbox. Polls assume the person who got the email is the member, so they can vote from their email even if they aren’t signed in to the site. You create polls in Outpost, then add one to a post from the Ghost editor.
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.
Once you save a poll as anonymous, it stays anonymous.
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.
You can add a draft poll to a post before you open it. Readers see “This poll isn’t open yet.” until you do. The panel keeps a tally for each copy you make, so you can see how many votes came from each post and from the newsletter. A post’s name links to the published post. A post Outpost doesn’t have a link for yet, such as a draft, shows its name without a link.
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.

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

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.
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.
Yes, unless the poll is anonymous. The Results card on the poll’s page lists each member and their choice.
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.