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:orvbscript: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/baseto 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.0in 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