Poll Field

The Poll Field is a custom post field that lets post authors add an interactive poll to their listing. Visitors vote directly on the page — no reload — and results update live. Perfect for engagement on listings, events, and community posts.

Overview

This field type adds a new Poll (VT) option when configuring post fields in Voxel. The post author creates the poll while submitting or editing their post: they write the question options and choose how voting works. Votes are handled via AJAX and stored per user.

Key Features

• Post authors build their own poll from the submission form
• Single-choice or multiple-choice voting (per poll)
• Optionally let voters add their own answer options
• Live AJAX voting — no page reload
• One vote per user; changing a vote in single-choice mode moves it
• Poll Display Widget for Elementor with progress bars and styling controls

Setup Instructions

Step 1: Enable the Field

1. Navigate to Voxel Toolkit → Post Fields in your WordPress admin
2. Find Poll Field in the list
3. Toggle the switch to enable

Step 2: Add Field to Post Type

1. Go to Voxel → Post Types
2. Select the post type to configure
3. Navigate to Fields tab
4. Click Add Field
5. Select Poll (VT)
6. Configure field settings
7. Save the post type

Step 3: Authors Create Their Poll

On the Create Post form, the author:

1. Adds one or more poll options
2. Optionally enables Allow users to add options — voters can submit their own answers
3. Optionally enables Allow users to choose multiple options — voting becomes checkboxes instead of radio buttons

Field Configuration

Setting	Description	Default
Label	Display name for the field	Poll
Key	Unique identifier for the field	poll
Description	Help text shown to users	Empty
Required	Whether the poll must be filled in	No

Per-Poll Options (set by the author)

Option	Description
Allow users to add options	Voters can add their own answer choices to the poll
Allow multiple options	Voters can select more than one answer
Lock votes once cast	Voters get one answer and cannot change it afterwards

Option Images

Authors can attach an image to each poll option from the submission form. Images appear in both voting displays, and how they are sized and framed is controlled on the Poll Display (VT) widget.

This turns a poll into a visual choice — which logo, which layout, which dish — rather than a list of text.

Voting Behavior

• Single choice: picking a different option moves the voter's vote
• Multiple choice: voters can select several options
• Locked: with Lock votes once cast on, the first answer is final. The poll still shows its results — only the controls are spent, and a note explains why. This is enforced on the server, so it holds even on a stale page.
• User-submitted options (when enabled) appear in the poll immediately and can be voted on like any other option

Who counts as a voter

Logged-in members are identified by their account. Logged-out visitors are told apart with a cookie, which is the most anonymous voting can offer — clearing it allows another vote. If a poll needs to be harder to game than that, put it behind a login.

Guest votes cast before 1.9.2

Before 1.9.2 every logged-out visitor was recorded as the same voter, so guests on a single-choice poll overwrote each other's votes. Those earlier votes are kept and still counted, but they belong to no one and cannot be changed. Only results gathered from 1.9.2 onwards are reliable for guest voting.

Poll Display Widget

Use the Poll Display (VT) Elementor widget to render the poll anywhere on your single-post template, with progress bars, vote counts, and full styling controls. See the Poll Display Widget documentation.

Use Cases

Community Voting

Let event organizers poll attendees on session topics, times, or venues.

Listing Engagement

Businesses ask customers quick questions — favorite dish, preferred opening hours, new services.

Content Feedback

Authors gather opinions from readers directly on the post.

Crowdsourced Options

With user-submitted options enabled, the audience builds the answer list themselves.

Troubleshooting

Field Not Appearing in Post Type

• Verify the Poll Field is enabled under Voxel Toolkit → Post Fields
• Clear any object caches
• Check that the Voxel theme is active and up to date

Votes Not Registering

• Ensure the visitor is logged in — votes are tracked per user account
• Check the browser console for JavaScript errors
• Verify no security plugin is blocking admin-ajax.php

Users Cannot Add Options

• The author must enable Allow users to add options on the poll
• The visitor must be logged in

Poll Not Showing on the Page

• Add the Poll Display (VT) widget to the single-post template, or confirm the field renders in your template
• Confirm the post actually has poll options saved