Skip to main content

Variant picker

Settings​

SettingIDTypeDefaultDescription
Block classclasstextmb-2
Select the first available variantselect_first_variantcheckboxtrue
Show for a single variantshow_singlecheckboxfalse
Dynamic availabilitydynamic_availabilityselectshowWhen an option is selected, options below it will be updated to show their availability
Variant styleselector_styleselectbutton
Sizeswatch_sizerange120
Widthswatch_widthselectauto
Shapeswatch_radiusselectrounded-circle
Backgroundswatch_bgcolor_background#ffffff
Border colorswatch_bordercolor#D1D5DB
Text colorswatch_textselectbase-text
Custom colorswatch_text_customcolor_background
Background - selectedswatch_bg_selectedcolor_background#ffffff
Border color - selectedswatch_border_selectedcolor#D63939
Text color - selectedswatch_text_selectedselectbase-text
Custom colorswatch_text_selected_customcolor_background
Sizebutton_sizerange120
Widthbutton_widthselectauto
Shapebutton_radiusselectrounded-md
Backgroundbutton_bgcolor_background#ffffff
Border colorbutton_bordercolor#D1D5DB
Text colorbutton_textselectbase-text
Custom colorbutton_text_customcolor_background
Background - selectedbutton_bg_selectedcolor_background#ffffff
Border color - selectedbutton_border_selectedcolor#D63939
Text color - selectedbutton_text_selectedselectbase-text
Custom colorbutton_text_selected_customcolor_background
Show radioenable_option_radiocheckboxfalseWhen variant style is buttons
Show swatches label textswatches_labelcheckboxfalse
Update url when variant selectedupdate_urlcheckboxfalse
Enable size guideenable_size_chartcheckboxfalse
Link labelsize_chart_labeltextSize guide
Variant option namesize_chart_varianttextSizeThis is usually 'Size'
Page containing size guidesize_chart_pagepage
Stylesize_chart_styleselectlink
Color schemasize_chart_colorselectsecondary
Custom colorsize_chart_color_customcolor#111827

Option values​

  • Dynamic availability (dynamic_availability): Off (off), Show (show), Hide (hide)
  • Variant style (selector_style): Buttons (button), Dropdown (dropdown)
  • Width (swatch_width): Auto (auto), Half (50%), Full (100%)
  • Shape (swatch_radius): Square (rounded-none), Rounded small (rounded-md), Rounded medium (rounded-xl), Rounded large (rounded-2xl), Rounded extra large (rounded-3xl), Squircle (rounded-squircle), Circle (rounded-circle), Pill (rounded-full), Rounded top (rounded-top), Rounded bottom (rounded-bottom), Single corner (rounded-corner), Diagonal corners (rounded-diagonal), Arch (rounded-arch), Dome (rounded-dome), Cylinder (rounded-cylinder), Barrel (rounded-barrel), Leaf pointed (rounded-leaf-point), Leaf (rounded-leaf), Lens (rounded-lens), Petal (rounded-petal), Egg (rounded-egg), Egg inverted (rounded-egg-inverted), Shield (rounded-shield), Drop (rounded-drop), Diamond (rounded-diamond), Blob (rounded-blob), Amoeba (rounded-amoeba), Flower (rounded-flower), Mountain (rounded-mountain), Pebble (rounded-pebble), Bean (rounded-bean), Cloud (rounded-cloud)
  • Text color (swatch_text): Primary (primary), Secondary (secondary), Success (success), Warning (warning), Danger (danger), Base text (base-text), Heading text (heading-text), Black (black), White (white), Gray 100 (gray-100), Gray 200 (gray-200), Gray 300 (gray-300), Gray 400 (gray-400), Gray 500 (gray-500), Gray 600 (gray-600), Gray 700 (gray-700), Gray 800 (gray-800), Gray 900 (gray-900), Random (random), Custom (custom)
  • Text color - selected (swatch_text_selected): Primary (primary), Secondary (secondary), Success (success), Warning (warning), Danger (danger), Base text (base-text), Heading text (heading-text), Black (black), White (white), Gray 100 (gray-100), Gray 200 (gray-200), Gray 300 (gray-300), Gray 400 (gray-400), Gray 500 (gray-500), Gray 600 (gray-600), Gray 700 (gray-700), Gray 800 (gray-800), Gray 900 (gray-900), Random (random), Custom (custom)
  • Width (button_width): Auto (auto), Half (50%), Full (100%)
  • Shape (button_radius): Square (rounded-none), Rounded small (rounded-md), Rounded medium (rounded-xl), Rounded large (rounded-2xl), Rounded extra large (rounded-3xl), Squircle (rounded-squircle), Circle (rounded-circle), Pill (rounded-full), Rounded top (rounded-top), Rounded bottom (rounded-bottom), Single corner (rounded-corner), Diagonal corners (rounded-diagonal), Arch (rounded-arch), Dome (rounded-dome), Cylinder (rounded-cylinder), Barrel (rounded-barrel), Leaf pointed (rounded-leaf-point), Leaf (rounded-leaf), Lens (rounded-lens), Petal (rounded-petal), Egg (rounded-egg), Egg inverted (rounded-egg-inverted), Shield (rounded-shield), Drop (rounded-drop), Diamond (rounded-diamond), Blob (rounded-blob), Amoeba (rounded-amoeba), Flower (rounded-flower), Mountain (rounded-mountain), Pebble (rounded-pebble), Bean (rounded-bean), Cloud (rounded-cloud)
  • Text color (button_text): Primary (primary), Secondary (secondary), Success (success), Warning (warning), Danger (danger), Base text (base-text), Heading text (heading-text), Black (black), White (white), Gray 100 (gray-100), Gray 200 (gray-200), Gray 300 (gray-300), Gray 400 (gray-400), Gray 500 (gray-500), Gray 600 (gray-600), Gray 700 (gray-700), Gray 800 (gray-800), Gray 900 (gray-900), Random (random), Custom (custom)
  • Text color - selected (button_text_selected): Primary (primary), Secondary (secondary), Success (success), Warning (warning), Danger (danger), Base text (base-text), Heading text (heading-text), Black (black), White (white), Gray 100 (gray-100), Gray 200 (gray-200), Gray 300 (gray-300), Gray 400 (gray-400), Gray 500 (gray-500), Gray 600 (gray-600), Gray 700 (gray-700), Gray 800 (gray-800), Gray 900 (gray-900), Random (random), Custom (custom)
  • Style (size_chart_style): Button (btn), Outline (btn-outline), Link (link)
  • Color schema (size_chart_color): Primary (primary), Secondary (secondary), Success (success), Warning (warning), Danger (danger), Base text (base-text), Heading text (heading-text), Black (black), White (white), Gray 100 (gray-100), Gray 200 (gray-200), Gray 300 (gray-300), Gray 400 (gray-400), Gray 500 (gray-500), Gray 600 (gray-600), Gray 700 (gray-700), Gray 800 (gray-800), Gray 900 (gray-900), Random (random), Custom (custom)

Presets​

  • Variant picker