For the complete documentation index, see llms.txt. This page is also available as Markdown.

Colour Picker Widget

Let customers personalise products with any colour or quick presets. Learn how to set up the Colour Picker Widget and connect it to your 3D meshes.

The Colour Picker widget lets customers dynamically change the connected materials in the configurator's front end. It is particularly useful for offering custom colour options.


How to set up the widget

1

Create the Colour Picker option block

  1. Navigate to the product admin's Options tab and click New Option Block.

  2. Select Colour Picker as the mode type.

  3. Configure the widget according to your preferences.

#
Name
Description

1

Material

The default material for the Colour Picker, which can be linked to a mesh. This is optional, as you can also use the Colour Picker to override other material parameters based on rules.

2

Show Presets

Selecting Yes allows you to define a list of presets for fast selections. Choose No to omit the presets.

3

Allow User to Clear Value

If set to No, the Colour Picker cannot be cleared. If set to Yes, the Colour Picker can be reset to blank in the configurator view.

4

Initial Value

If Allow User to Clear Value is set to No, this field becomes visible. It defines the starting value for the widget. The starting value will be this one unless a different starting value is set in your default configuration, in which case the default configuration takes the highest priority.

5

Presets

If Show Presets is set to Yes, this section appears, allowing you to add colour presets for quick selection.

Colour Picker option block settings on the product Options tab
2

Assign it to a group and save

  1. Assign your Colour Picker to a group for it to appear.

  2. Save your work.

Colour Picker option assigned to a group, with Save Changes

Connecting the Colour Picker

There are several ways to connect the Colour Picker to a specific mesh. Here are three common approaches:

If you've added a default material, the Colour Picker should be the primary option for configuration.

  1. Navigate to the 3D tab and go to the Meshes section.

  2. Find the meshes you want to assign the widget to.

  3. Choose mode Dynamic and select the Colour Picker as the value.

Meshes section in the 3D tab with the Colour Picker selected as a dynamic value

To use the Colour Picker based on specific rules, use the Trigger and Action rule logic. For instance, set a trigger like "Select custom colour" and then choose an action, such as overriding meshes with another material (for example, the Colour Picker).

Rule with a trigger and an Override Material action using the Colour Picker

Alternatively, override material parameters. The material parameters window opens, allowing you to override the currently selected material with the Colour Picker as an albedo input.

Override Material Parameters window with the Colour Picker as the albedo input

Picking and reusing colours

The colour picker includes tools that make it quicker to choose and reuse colours. They are available in standard and modular configurators, in admin colour settings and in AI Studio.

#
Tool
What it does

1

Pick from screen

Samples a colour from anywhere on your screen, for example from a brand guide or a photo open in another window.

2

Recently Used

Lists your last 16 colours, newest first, together with their opacity. Select one to reuse it in any colour field.

3

Value labels

In configurator colour pickers, drag the red, green and blue value labels to adjust their numbers. Where opacity is available, you can drag its label too.

Pick from screen depends on your browser. If your browser doesn't support screen colour picking, you can still choose colours with the palette, hue slider or values.


Configurator view appearance

The appearance of the Colour Picker in the configurator view varies based on the theme used. Below are examples of how it appears in the Mimeeq theme:

Colour Picker with presets in the desktop configurator view
Colour Picker open in the desktop configurator view
Colour Picker with presets in the mobile configurator view
Colour Picker open in the mobile configurator view

Thumbnail Widget

Display option sets as a visual grid of swatches or images.

Print on Demand

Let customers place their own images and logos on products.

Button Widget

Add buttons that reset options, guide steps or fire events.

Last updated

Was this helpful?