Articles on: Configurator

Button Widget Setup Guide

Content

  1. Overview
  2. How to Add a Button Widget
  3. Button Configuration Settings
  4. Implementation Examples
  5. Troubleshooting


Overview


The Button widget in Mimeeq allows you to create interactive buttons that trigger rules when clicked. These buttons can be used to enhance your configurator's functionality by resetting options, navigating between groups, or creating step-by-step workflows.


Common Use Cases


  • Reset Options: Clear selected options within a group
  • Navigation: Create "Next" buttons to guide users through a step-by-step configuration process
  • Events: Trigger specific events for integration with your website


How to Add a Button Widget


  1. Navigate to Admin Settings
  2. Open your configurator
  3. Go to the Options tab
  4. Click New Option
  5. Select Button as the mode
  6. Configure your button settings


Button Configuration Settings


Setting

Options

Description

Name

Simple input field

The button label

Button Width

Full Width, Half Width

Full Width: Button spans the entire container width. Half Width: Button takes up 50% of the container width. To create a 50-50 split, add two separate half-width button widgets to the same group

Button Size

Small, Medium

Small: Compact button size for minimal layouts. Medium: Larger button size for better visibility

Text Case

Normal, Uppercase

Normal: Standard text capitalization. Uppercase: All text displayed in uppercase letters

Button Variant

Filled, Outlined, Text

Filled: Solid background color with text. Outlined: Border with transparent background. Text: Text-only button without border or background

Button Shape

Pill, Rectangle, Rounded

Pill: Fully rounded edges for a modern look. Rectangle: Square corners for a classic appearance. Rounded: Slightly rounded corners for a soft edge

Button Colour

Accent, Accent Light, Gray, Custom

Accent: Uses your main theme color. Accent Light: Lighter shade of your theme color. Gray: Predefined gray color scheme. Custom: Define your own color scheme

Default Button Background

Colour picker field

Background color of the button in its normal state. Available when "Custom" is selected for Button Color

Hover Button Background

Colour picker field

Background color when user hovers over the button. Available when "Custom" is selected for Button Color

Default Text Colour

Colour picker field

Text color of the button in its normal state. Available when "Custom" is selected for Button Color

Hover Text Colour

Colour picker field

Text color when user hovers over the button. Available when "Custom" is selected for Button Color

Event Name

Simple input field

Custom event name for JavaScript integration on your website (optional)

Button Preview

Live preview of the button widget


Button Configuration Settings


Implementation Examples


Example 1: Reset Button


In this example, we'll create a reset button for a "Design Cover" group:


  1. Create a button widget named "Reset Design Cover"
  2. Add it to the "Design Cover" group
  3. Configure a rule to reset the cover options when clicked
  4. The button will automatically hide when there are no selections to reset



Example 2: Step-by-Step Navigation


Create a guided configuration flow:


  1. Add a "Next" and "Previous" button at the end of each group
  2. Configure the button to open the next group when clicked
  3. Optionally, add a rule to rename the current group after navigation
  4. This creates a step-by-step process that guides users through your configurator



Troubleshooting


Buttons Not Appearing


  • Verify the button widget is properly added to a group
  • Ensure the button width settings match your layout requirements


Half-Width Buttons Not Aligning


  • Confirm you've added exactly two half-width buttons to the same group
  • Check that both buttons have the same size and styling settings


Custom Colors Not Working


  • Verify you've selected "Custom" in the color options
  • Ensure all four custom color fields are properly filled
  • Check that color values are in the correct format




Updated on: 21/11/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!