Checklist Display (VT)

Renders a Checklist (VT) post field on the front end — the items, a progress bar, and the tick interaction.

Enabled automatically with the field

Enabling the Checklist (VT) post field switches this widget on for you. You can still toggle it under Voxel Toolkit → Widgets.

Setup

1. Enable the Checklist (VT) field under Voxel Toolkit → Post Fields.
2. Add the field to a post type in Voxel → Post Types.
3. Place Checklist Display (VT) on that post type's single template.
4. Select which checklist field to render.

Checklist Settings

Control	Purpose
Select Checklist Field	Which Checklist (VT) field to render
Hide if No Items	Hide the widget rather than render an empty checklist
Show Progress Bar	Display completion as a bar
Show Percentage Text	Display completion as a percentage
Show Checked Timestamp	Show when each item was ticked
Hide Checked Items	Show only what's outstanding
Hide Unchecked Items	Show only what's done

Hide Checked and Hide Unchecked are a pair

Turning both on leaves nothing to display. Use one at a time — Hide Checked for a "what's left" view, Hide Unchecked for a completed-work summary.

Text Settings

Control	Purpose
Empty Message	Shown when the checklist has no items
Progress Text	Wording around the progress indicator

Per-user or global

Whether each visitor tracks their own progress or everyone shares one state is a field setting, not a widget setting — see Post Fields.

The widget renders whichever mode the field is in. Per-user progress needs the visitor to be logged in, since there's no account to store it against otherwise.

Styling

Elementor controls for the checkbox, item text, progress bar, and timestamps.

Troubleshooting

Nothing renders

• Confirm the post has items in its Checklist (VT) field
• Confirm Select Checklist Field points at the right field
• Check whether Hide if No Items is hiding it by design
• Check that Hide Checked Items and Hide Unchecked Items aren't both on

Progress doesn't persist between visits

Per-user tracking needs a logged-in user. For anonymous visitors there's no account to store progress against — either require login or switch the field to global tracking.

Everyone sees the same ticks

The field is in global mode. Change it to per-user in the post type field settings.

Timestamps are blank

Items ticked before Show Checked Timestamp was enabled have no recorded time. New ticks record one.

Developers

Ticking an item fires voxel_toolkit/checklist/item_checked — see the Developer Reference.