- This feature is not being brought to the new Unified Community Platform (UCP).
See Help:UCP for more information on the new platform. - This extension can be enabled or disabled using Wiki Features.
- This extension is enabled by default on Fandom.
You can add polls to your community using simple syntax.
Please note that standard polls do not properly function on the mobile skin. See information about alternative options at the bottom of this page.
Step by step
- Open the source editor.
- Find the place on the page where you want to add a poll.
- Copy the following code and edit it as needed:
<poll> Title of poll Choice 1 Choice 2 etc. </poll>
- For example, here is a customized poll:
<poll> What Is Your Favorite Color? Red Green Blue Yellow Other </poll>
- Save the page. Now anyone can vote in your poll! The end result:
How does it work?
Votes are registered under your username, or your IP address if you're not logged in. This means the poll does not take a reliable count of unique individuals and it should not be used for important purposes.
Users can change their vote at any time.
The poll will display the number and percentage of votes for each choice, the total number of votes given so far, and the date and time when the poll was created.
Identical polls posted in different places on your site will act as different data entry points for the same poll. If multiple polls are desired, each instance must differ somehow in their source code.
Can the votes be reset?
It is not possible to end, i.e. to 'freeze', a poll. All polls last indefinitely.
To reset all votes, change either the title or one of the poll's choices (which will, in effect, create a new poll).
Since it's so easy to change and reset polls, past poll results can easily be lost. Reverting to the version prior to the reset may allow you to reclaim the information, but you should not rely on this functionality. If historical polls are important to you, it is safest to record the results in some other form such as a screenshot or simply text.
Customization options
It is possible to customize the design of the poll extension via CSS.
Changing the width of the poll
By default, polls are 40em wide. Admins can change a poll's width using the following CSS:
div.ajax-poll { width: auto !important; }
This will need to be added to the community's CSS file (see Help:Community CSS and JS). It will make all polls as wide as the "box" they're in, i.e. they'll usually expand to be as wide as the article body. You can now set its width by wrapping it in a div with a set width, a table cell, or in any other layout box. For example:
<div style="width: 250px;"> <poll> How wide is this poll? Wide Not so wide Sort of wide </poll> </div>
The end result:
Other options
- The Discussions feature includes a poll function. Polls within Discussions are under development and may not be available on every community.
Further help and feedback
- Browse and search other help pages at Help:Contents
- Check Fandom Community Central for sources of further help and support
- Check Contacting Fandom for how to report any errors or unclear steps in this article
