Version 5.1.0

November 12, 2026

Added

  • Added Visual Choice and Visual Multi-Choice fields for single and multiple selections, with configurable options and selection limits.
  • Added Position fields with configurable spatial arrangements and keyboard navigation.
  • Added a new Width field with explicit percentage stops, Bar and Width samples styles, and configurable labels and tooltips.
  • Added Rating fields with whole-number values, configurable limits and defaults, optional clearing, and star, heart, circle or diamond symbols.
  • Added reusable Action Links fields for conditional editor links, with configurable labels, icons, images and button styles.
  • Added Buttons, Button group, Chips, List, Tiles, Cards, Swatches and Visual samples presentations for visual choices, plus Dropdown for single choices.
  • Added visual option metadata for descriptions, icons, images, colours, split colours, foreground/background pairs, gradients, width, aspect ratio, typography and shapes.
  • Added shared option sets managed in the control panel or configuration files, with project-config support and the option to copy choices into individual fields. Visual choices can also receive options dynamically through PHP events.
  • Added built-in and customisable presets for visual choices, Position, Width and Rating, with appearance settings and live field previews.
  • Added configurable icon and image galleries, with support for selecting Craft assets.
  • Added typed Twig values for visual choices, Position and Width, typed GraphQL output for visual choices and Position, and integer GraphQL output for Rating.
  • Added element previews, search, conditions, sorting and inline editing for the new content fields, according to each field’s capabilities.
  • Added command-line previews and optional conversion of existing Buttons, Colours, Text Size, Width, Stars and Triggers fields to their replacements.

Changed

  • Button Box now requires Craft CMS 5.10.11 or greater.
  • Triggers field JavaScript values are now output as written, without parsing element tags.
  • Triggers field links no longer output javascript:, data: or vbscript: URLs. Use a JavaScript trigger instead.

Deprecated

  • Deprecated the original Buttons, Colours, Text Size, Width, Stars and Triggers fields, which now display a Legacy label and log control-panel deprecation notices. Existing fields retain their settings and stored values; conversion is optional.

Version 5.0.6

November 1, 2026

Fixed

  • Fix Triggers field buttons outputting encoded base64: values for their link or JavaScript, and not parsing element tags.
  • Fix Button Box log messages being written to the Asset Count log file.

Version 5.0.5

October 22, 2026

Changed

  • Updated the frontend build toolchain to Vite 8.3.4.

Version 5.0.4

October 2, 2026

Changed

  • Updated the required version of verbb/base to 3.0.19.

Version 5.0.3

September 14, 2026

Changed

  • Updated documentation for clearer, more consistent guidance.

Version 5.0.2

July 15, 2026

Fixed

  • Fix large button style for Triggers and Width types.

Version 5.0.1

July 18, 2025

Changed

  • Update English translations.

Version 5.0.0

May 11, 2024

Changed

  • Now requires PHP 8.2.0+.
  • Now requires Craft 5.0.0+.

Fixed

  • Fix an error with normalizeValue() when editing fields.

Version 4.2.6

July 15, 2026

Fixed

  • Fix large button style for Triggers and Width types.

Version 4.2.5

July 18, 2025

Changed

  • Update English translations.

Version 4.2.4

March 4, 2024

Fixed

  • Fix an issue where fields weren’t being initialized properly when in Matrix/Super Table/Neo blocks.

Version 4.2.3

February 8, 2024

Added

  • Added “Placeholder Text” field setting for Colour and Text Size fields.

Changed

  • Colour and Text Size fields now show a dropdown consistent with Craft’s UI.

Fixed

  • Fix Colour and Text Size fields not triggering an updated value call when changing their value.
  • Fix double-binding of JS menubtn for some fields.
  • Fix an error when displaying Colour and Text Size buttons for new elements.

Version 4.2.2

October 5, 2023

Added

  • Add “Image Align” option to “Buttons” buttons.

Changed

  • Improve alignment of “Buttons” type fields.

Fixed

  • Fix default value for fields not working correctly in some instances.
  • Fix invalid (removed) options causing issues when save fields.

Version 4.2.1

August 12, 2023

Changed

  • Update color for button labels for better contrast.

Fixed

  • Fix some fields using the first option automatically as the default value.

Version 4.2.0

March 9, 2023

Changed

  • Now requires Craft 4.4.0+.

Fixed

  • Fix a type error occurring on Craft 4.4.0+.

Version 4.1.0

June 29, 2022

Changed

  • Now requires Craft 4.1.0+.

Fixed

  • Fix a type error occurring on Craft 4.1.0.

Version 4.0.3

June 21, 2022

Changed

  • Now requires Button Box 3.0.0 in order to update from Craft 3.

Removed

  • Removed Craft 2 migration.

Version 4.0.2

June 21, 2022

Fixed

  • Fix an error when creating new fields.

Version 4.0.1

June 21, 2022

Fixed

  • Merge fixes from 3.0.2.

Version 4.0.0

June 20, 2022

Changed

  • Now requires PHP 8.0.2+.
  • Now requires Craft 4.0.0+.

Version 3.1.0

June 29, 2022

Changed

  • Now requires Craft 3.7.46+.

Fixed

  • Fix a type error occurring on Craft 3.7.46.
  • Fix colour field default value not being set correctly.

Version 3.0.2

June 21, 2022

Fixed

  • Fix an error when saving a Colour field.

Version 3.0.1

June 20, 2022

Added

  • Add Craft 2 migration (thanks @bossanova808).
  • New icon.

Version 3.0.0

June 4, 2022

Changed

  • Migration to verbb/buttonbox.
  • Now requires Craft 3.7+.

Version 2.0.4

June 20, 2019

Fixed

  • Merge the fix by @lindseydiloreto about Trigger field

Version 2.0.3

April 8, 2019

Fixed

  • Fixes Mulitsite error normalizeValue #25

Version 2.0.2

July 13, 2018

Fixed

  • Fix PHP 7.2 count error for buttons, text size and width field types

Version 2.0.1

June 14, 2018

Fixed

  • Fix PHP 7.2 count error

Version 2.0.0

April 9, 2018

Added

  • Initial Craft CMS 3 release