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
4. Click Save Changes

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

Voting Behavior

• Votes are tracked per logged-in user
• Single choice: picking a different option moves the user's vote
• Multiple choice: users can vote for several options
• User-submitted options (when enabled) appear in the poll immediately and can be voted on like any other option

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