NueForm

Fuse Poll Activities

Documentation for Classic Poll, Multi-Vote Poll, Image Poll, This or That, Ranked Poll, Elimination Poll, Sliding Scale, and Would You Rather activities.

Classic Poll

Pick one option and see live percentages update in real-time as others vote.

Activity type: classic_poll

Configuration

PropertyTypeDescriptionDefault
optionsarrayArray of poll options. Each has id, label, and optional color.2 default options

Option Object

FieldTypeDescription
idstringUnique identifier for the option.
labelstringDisplay text for the option.
colorstringAccent color for the option's bar/highlight. Auto-assigned from the color palette if not set.

Behavior

  • Each participant can vote for exactly one option.
  • After voting, the participant sees the live results (percentages and vote counts).
  • This is a single-action activity: once voted, the participant enters read-only mode.

Display Modes

ModeDescription
inline_barsResults shown as horizontal bars within each option.
bar_chartResults shown as a separate vertical bar chart.

Aggregated State

FieldTypeDescription
optionsPollOption[]Options with vote counts, percentages, and voter lists.
totalVotesnumberTotal number of votes cast.
myVotesstring[]Option IDs the current participant voted for.

CSS Selectors

.fuse-classic-poll, .fuse-poll, .fuse-poll--bar-chart, .fuse-bar, .fuse-bar-label, .fuse-option, .fuse-option-label, .fuse-option-percentage, .fuse-option-votes


Multi-Vote Poll

Vote for multiple options at once. Perfect for "select all that apply" scenarios.

Activity type: multi_vote_poll

Configuration

PropertyTypeDescriptionDefault
optionsarrayArray of poll options with id, label, and optional color.2 default options

Behavior

  • Participants can vote for multiple options.
  • Votes can be toggled on and off -- clicking a voted option removes the vote.
  • This is a multi-action activity: participants can change their votes at any time.
  • Results update in real-time as votes are toggled.

Aggregated State

Same as Classic Poll.

CSS Selectors

.fuse-multi-vote-poll, plus all shared poll selectors.


Image Poll

Vote on images instead of text. Great for design picks, outfits, or product choices.

Activity type: image_poll

Configuration

PropertyTypeDescriptionDefault
optionsarrayArray of poll options. Each has id, label, and imageUrl.2 default options

Option Object

FieldTypeDescription
idstringUnique identifier.
labelstringText label displayed below the image.
imageUrlstringURL of the image to display for this option.
colorstringOptional accent color.

Behavior

  • Options are displayed as image cards with labels.
  • Each participant can vote for one image.
  • This is a single-action activity.
  • Results show vote percentages overlaid on or below the images.

Aggregated State

Same as Classic Poll, with imageUrl available on each option.

CSS Selectors

.fuse-image-poll, plus all shared poll selectors.


This or That

Binary swipe-style choice between two options with live percentage splits.

Activity type: this_or_that

Configuration

PropertyTypeDescriptionDefault
optionsarrayExactly 2 options with id, label, and optional color.[{ label: "This" }, { label: "That" }]

Behavior

  • Two options are presented side by side in a split-screen layout.
  • Each participant selects one of the two options.
  • This is a multi-action activity: participants can switch their vote.
  • The live percentage split is displayed as a visual divider between the two panels.

Aggregated State

Same as Classic Poll (with exactly 2 options).

CSS Selectors

.fuse-this-or-that, .fuse-panel--left, .fuse-panel--right, .fuse-panel-label, .fuse-panel-percentage


Ranked Poll

Drag to rank options in your preferred order. See the community consensus ranking emerge.

Activity type: ranked_poll

Configuration

PropertyTypeDescriptionDefault
optionsarrayArray of options to rank. Each has id, label, and optional color.3 default options

Behavior

  • All options are displayed in a list.
  • Participants drag items to reorder them from most preferred to least preferred.
  • Once submitted, the participant's ranking is recorded.
  • This is a single-action activity: the ranking is submitted once.
  • The consensus ranking is calculated by averaging all participants' rankings.

Aggregated State

FieldTypeDescription
optionsarrayOptions with id, label, avgRank, and rankings count.
totalParticipantsnumberTotal number of participants who submitted rankings.

CSS Selectors

.fuse-ranked-poll, .fuse-rank-number, plus shared selectors.


Elimination Poll

Multi-round voting where the lowest-voted option gets eliminated each round until a winner remains.

Activity type: elimination_poll

Configuration

PropertyTypeDescriptionDefault
optionsarrayArray of options with id, label, and optional color.2 default options

Behavior

  • Participants vote for their favorite option in the current round.
  • After a round completes, the option with the fewest votes is eliminated.
  • A new round begins with the remaining options.
  • The process repeats until only one option remains -- the winner.
  • This is a multi-round activity: participants need to continue voting in subsequent rounds.
  • Participants who already voted in a round can rejoin to vote in the next round.

Aggregated State

FieldTypeDescription
currentRoundnumberThe current round number.
activeOptionsPollOption[]Options still in the competition with vote data.
eliminatedOptionsarrayOptions eliminated so far, with the round they were eliminated in.
totalVotesThisRoundnumberTotal votes in the current round.
isCompletebooleanWhether the elimination has concluded (one winner remains).
winnerobjectThe winning option (set when isComplete is true).

CSS Selectors

.fuse-elimination-poll, .fuse-round-label, .fuse-champion, plus shared poll selectors.

Elimination Polls work best with 4+ options. With only 2 options, it effectively becomes a single-round Classic Poll.


Sliding Scale

Place yourself on a spectrum and see the live distribution curve of all responses.

Activity type: sliding_scale

Configuration

PropertyTypeDescriptionDefault
minnumberMinimum value on the scale.0
maxnumberMaximum value on the scale.100
stepnumberStep increment for the slider.1
minLabelstringLabel for the minimum end of the scale.""
maxLabelstringLabel for the maximum end of the scale.""
scaleStylestringVisual style of the slider track."thin"
barColorstringCustom color for the distribution bars."" (uses theme accent)

Behavior

  • Participants drag a slider to select a value on the spectrum.
  • After submitting, they see a histogram showing the distribution of all responses.
  • Statistics (average, median, total responses) are displayed.
  • This is a single-action activity.

Aggregated State

FieldTypeDescription
distributionnumber[]Histogram bucket counts (e.g., 10 buckets from min to max).
averagenumberMean value of all responses.
mediannumberMedian value of all responses.
totalResponsesnumberTotal number of responses.
minnumberScale minimum value.
maxnumberScale maximum value.

CSS Selectors

.fuse-sliding-scale, .fuse-slider, .fuse-slider-value, .fuse-slider-label, .fuse-stats, .fuse-histogram, .fuse-histogram-bar, .fuse-stat-value, .fuse-stat-label


Would You Rather

Choose between two dilemmas and see the live split. Endlessly debatable.

Activity type: would_you_rather

Configuration

PropertyTypeDescriptionDefault
optionsarrayExactly 2 options with id, label, and optional color.[{ label: "This" }, { label: "That" }]

Behavior

  • Two options are presented side by side.
  • Participants choose one option.
  • This is a multi-action activity: participants can switch their choice.
  • The live percentage split is shown as a visual divider.

Difference from This or That

Would You Rather and This or That are functionally identical. The distinction is thematic:

  • This or That: General preference comparisons (e.g., "Coffee or Tea?").
  • Would You Rather: Dilemma-based questions (e.g., "Would you rather fly or be invisible?").

Aggregated State

Same as Classic Poll (with exactly 2 options).

CSS Selectors

.fuse-would-you-rather, .fuse-panel--left, .fuse-panel--right, .fuse-panel-label, .fuse-panel-percentage

Color Palette

When options do not have a custom color assigned, NueForm automatically assigns colors from a vibrant palette:

  1. Indigo (#6366f1)
  2. Amber (#f59e0b)
  3. Emerald (#10b981)
  4. Red (#ef4444)
  5. Violet (#8b5cf6)
  6. Cyan (#06b6d4)
  7. Orange (#f97316)
  8. Pink (#ec4899)
  9. Teal (#14b8a6)
  10. Purple (#a855f7)
  11. Lime (#84cc16)
  12. Rose (#e11d48)

Colors are assigned in sequence based on the option's position. When there are more options than colors, the palette wraps around.

Dernière mise à jour : 6 avril 2026