Interactive · Gutenberg

Random Picker block for WordPress

Enter a list of items and pick a random winner with an animated highlight effect.

Get Blockenberg

Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.

Get Blockenberg

What it actually does

Enter a list of items and pick a random winner with an animated highlight effect.

Inspector panels on this block: Header, Picker Settings, Sizing & Layout. Those titles come from index.js, not from a shared template.

Behavior controls: “Item Separator” options: One Per Line, Comma Separated.

Where to find it

Gutenberg inserter → Interactive → search “Random Picker” (block name `blockenberg/random-picker` in block.json). Style it in the sidebar after insert.

How to use Random Picker block for WordPress

  1. Install Blockenberg. Install from WordPress.org and activate the plugin.
  2. Insert the block. Edit a page, click +, search for “Random Picker”, insert it. Category: Interactive.
  3. Configure inspector controls that exist on this block. Open Header. Set “Show Title”, “Show Subtitle”, “Header — Title”, “Subtitle”.
  4. Check the published page. The view script reads HTML data attributes: data-opts. The block editor preview may not run the same view script.

Inspector controls from this block’s code

ControlWhat the code does
Show TitleOn/off toggle in the inspector. On by default. Saved as `showTitle`.
Show SubtitleOn/off toggle in the inspector. On by default. Saved as `showSubtitle`.
Header — TitleText field in the inspector. block.json default: Random Picker. Saved as `title`.
SubtitleText field in the inspector. block.json default: Enter your items, click Pick, and let luck decide!. Saved as `subtitle`.
Button LabelText field in the inspector. block.json default: Pick Random!. Saved as `buttonLabel`.
Item SeparatorSelect control; the chosen value is saved on the block. Options: One Per Line; Comma Separated. block.json default: lines. Saved as `inputMode`.
Allow Re-pickOn/off toggle in the inspector. On by default. Saved as `allowRepick`.
Show Pick HistoryOn/off toggle in the inspector. On by default. Saved as `showHistory`.
Animation StepsNumeric range control in the inspector. Range 4–30. block.json default: 12. Saved as `animSteps`.
Animation Speed (ms)Numeric range control in the inspector. Range 20–200. block.json default: 60. Saved as `animSpeedMs`.
Typography — TitleShared Blockenberg typography popover (family, size, weight, spacing). Saved as `titleTypo`.
Subtitle (Subtitle Typo)Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `subtitleTypo`.
WinnerShared Blockenberg typography popover (family, size, weight, spacing). Saved as `winnerTypo`.
Card Border RadiusNumeric range control in the inspector. Range 0–40. block.json default: 16. Saved as `cardRadius`.
Item Border RadiusNumeric range control in the inspector. Range 0–24. block.json default: 8. Saved as `itemRadius`.
Max Width (px)Numeric range control in the inspector. Range 300–900. block.json default: 520. Saved as `maxWidth`.
Padding Top (px)Numeric range control in the inspector. Range 0–160. block.json default: 60. Saved as `paddingTop`.
Padding Bottom (px)Numeric range control in the inspector. Range 0–160. block.json default: 60. Saved as `paddingBottom`.

What the front-end script actually does

When this is the right block

Notes from the implementation

viewScript: this folder’s frontend.js is enqueued on the front end for this block.

FAQ

How do I add the Random Picker block in WordPress?

Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Random Picker”. It sits under Interactive. After insert, open Header and set “Show Title”, “Show Subtitle”, “Header — Title”, “Subtitle”.

What makes Random Picker different from other Blockenberg blocks?

Enter a list of items and pick a random winner with an animated highlight effect. Inspector labels on this block include “Show Title”, “Show Subtitle”, “Header — Title”, “Subtitle”.

Is the Random Picker Gutenberg block free?

Yes. Random Picker ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.

Can I style Random Picker to match my theme?

Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Header, Picker Settings, Sizing & Layout).

Related interactive blocks

Get Blockenberg

Install Blockenberg from WordPress.org, then insert Random Picker from the Gutenberg inserter.

Get Blockenberg