Introduction

Triggers and Actions are powerful tools within the Mimeeq system that allow you to create dynamic product configurations with conditional logic. This guide will walk you through the basics of setting up and using these features.

What are Triggers and Actions?

Triggers are conditions that, when met, activate one or more actions.
Actions are changes that occur in your configurator when a trigger condition is met.
Together, these create "if-then" rules for your product configurations: "If this happens (trigger), then do this (action)."

Accessing the Rules Section

To begin working with triggers and actions:

1. Navigate to the Product Admin area
2. Click on the Rules tab

Creating Rule Containers

Rule containers help you organize your rules for better management:

1. In the Rules tab, click the Add Container button
2. Name your container according to its purpose (e.g., "Fabric Dependencies," "Pricing Rules," etc.)

Adding a New Rule

To create a rule within a container:

1. Select your rule container
2. Click the Add Rule button
3. Enter a descriptive name for your rule (e.g., "Velvety Fabric - Metal Legs")

Setting Up Triggers

Every rule needs at least one trigger condition:

1. Click Add Trigger
2. Select the trigger type from the dropdown menu

Trigger Types

Mimeeq offers several trigger types:

• Always Active: Rule is constantly applied (good for defaults, zoom settings, etc.)
• Events: Activated by specific user interactions (e.g., clicking hotspots)
• Filter: Based on filter attributes
• Option Set: Activated when specific option sets are selected

For detailed information on each trigger type, please refer to our dedicated trigger documentation - Rules - Triggers Overview

Example: Option Set Trigger

To create a trigger based on an option set selection:

1. Select Option Set as the trigger type
2. Choose the specific option set (e.g., "Fabric")
3. Select the option value that will activate the trigger (e.g., "Velvety")
4. Set the Inclusion Type:

• Is one of: Trigger activates when the selected option(s) are chosen
• Is not one of: Trigger activates when anything EXCEPT the selected option(s) are chosen

Adding Actions

Once you've set up your trigger(s), you need to define what happens when the trigger conditions are met:

1. Click Add Action
2. Select the action type
3. Configure the specific parameters for that action

See our triggers guide for a full list of Triggers ** **- Rules - Actions Overview

Example: Select Parameter Action

To automatically select another parameter when your trigger activates:

1. Choose Select Parameter as the action type
2. Select the parameter to modify (e.g., "Leg Type")
3. Choose the value to be selected (e.g., "Metal")
4. Click Save

Multiple Triggers and Actions

You can create complex logic by adding multiple triggers and actions to a single rule:

• Multiple Triggers: All trigger conditions must be met (they work as AND conditions)
• Multiple Actions: All actions will execute when the trigger conditions are met

Testing Your Rules

After creating your rules:

1. Click the Preview button in the top right corner
2. Test your configuration by interacting with it
3. Verify that your triggers and actions work as expected

Example Use Case

In our example:

1. We created a rule that triggers when the "Velvety" fabric is selected
2. The action automatically selects "Metal" as the leg type
3. When testing in preview mode, selecting the Velvety fabric option automatically changes the leg type to Metal

This simple example demonstrates how you can create relationships between different configuration options to enhance your customer's experience or enforce specific product rules.

Best Practices

• Give your rules clear, descriptive names
• Organize related rules into dedicated containers
• Test your rules thoroughly after creation
• Consider the user experience when creating automatic selections
• Document your rule logic for team reference

Important Rules for Avoiding Trigger Loops

Watch Out For:

1. Bidirectional Rules

• Avoid creating opposing rules like:
• Rule 1: If Fabric = Velvet → Set Legs = Metal
• Rule 2: If Legs = Metal → Set Fabric = Velvet
  

2. Chain Reactions

• Be cautious with cascading rules where:
• Rule A triggers Rule B
• Rule B triggers Rule C
• Rule C might trigger Rule A
  

3. Parameter Cross-Dependencies

• Monitor rules that modify multiple parameters simultaneously
• Verify that parameter changes don't trigger conflicting rules

Further Resources

For more detailed information on specific trigger types and actions, please refer to our dedicated documentation:

• Trigger Types Documentation - Rules - Triggers Overview
• Action Types Documentation - Rules - Actions Overview

Updated on: 15/04/2025