> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/commerce-and-integrations/mimeeq-basket/pricing-rules.md). # Pricing Rules Learn how to create and manage basket pricing rules in Mimeeq with this step-by-step guide. Discover how to apply conditions and actions to automate pricing adjustments. ## Content 1. [Introduction to Pricing Rules](#introduction-to-pricing-rules) 2. [How to Create Pricing Rule](#how-to-create-pricing-rule) * [Rule Settings](#rule-settings) * [Pricing Rule Groups](#pricing-rule-groups) * [Conditions](#conditions) * [Actions](#actions) 3. [How to Search, Delete and Copy Pricing Rules](#how-to-search-delete-and-copy-pricing-rules) 4. [Live Demo Preview of Basket with Pricing Rules](#live-demo-preview-of-basket-with-pricing-rules) ## Introduction to Pricing Rules Pricing rules for Basket allow you to adjust the total value by applying discounts or adding extra charges, like partner-specific discounts or delivery fees. You can configure rules based on Basket value or Custom Fields, specifying currency and customer scope. Adjustments can be set as a fixed amount or a percentage of the Basket total. {% hint style="info" %} For a step-by-step guide on how to configure Basket, visit our [Detailed Help Article 🔗](/commerce-and-integrations/mimeeq-basket/overview.md). {% endhint %} ## How to Create Pricing Rule To create a pricing rule, navigate to **Settings** → **Basket** → **Pricing Rules** tab. To add a new rule, click the **Add Rule** button. ![How to Create Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FBGHfABxzHdICvZIJQUkS%2Fpricing-rule-image-1_6vb5jf.png?alt=media) #### Rule Settings In this section, you can configure the basic details and scope of the pricing rule: | | Name | Description | | - | ------------------ | -------------------------------------------------- | | | Internal Rule Name | Name visible only to the admin for easy navigation | | | Currency | Select the currency for which the rule applies | | | Rule Applies To | Choose the user scope from a dropdown | ![Basic Rule Settings](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FnLMKDzF9s3bT7xfbkb3o%2Fpricing-rule-image-2-new_1oku59o.png?alt=media) To define the scope of the rule, choose from the following options: * Everyone: Rule applies to all users. * Not Logged In Visitors: Applies only to users not logged in. * Only Logged In Users: Visible only to logged-in users. * Specific Company Groups: Select specific Company Groups from a multi-select dropdown. #### Pricing Rule Groups A Pricing Rule can consist of multiple groups, each combining various conditions and actions. This setup allows you to create a rule for the same currency and scope within a single rule. \*\*Key components: \*\* * Group Name: Each group can have a distinct name for easy identification. * Conditions: Determines when the rule will be triggered. * Actions: Specifies what happens when the conditions are met. ![Pricing Rule Group Key Components](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FW4QNyrtDCEY328bdhEFg%2Fpricing-rule-image-3_28qq0x.png?alt=media) #### Conditions In a pricing rule, conditions define when the rule will be triggered. Currently, two trigger types are supported: **Basket Value** and **Custom Fields**. Basket Value rule triggers based on the total Basket value. Conditions available for the Basket value are: * Is Equal * Is Greater Than * Is Greater Than or Equal * Is Less Than * Is Less Than or Equal **Example:** You can set a rule that applies a 10% discount to Baskets with a value greater than $5,000. ![Example of Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F8kwWVMpRrF3WSPsVsoBD%2Fpricing-rule-image-4_oi4o3v.png?alt=media) Custom Field rule triggers based on a specific custom field selection. Choose the relevant custom field and specify one or more values from it. For instance, you might select a “Delivery Type” field and apply different actions depending on the option chosen. {% hint style="info" %} Currently, only Single-select Custom Fields in the Basket is supported, with plans to expand to other types in the future. For a step-by-step guide on how to create and use Custom Fields in the Basket, visit our [Detailed Help Article 🔗.](/platform/custom-fields/custom-fields.md) {% endhint %} **Example:** You can set a rule to apply an additional 5% charge when the selected delivery type is Standard Delivery. ![Example of Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FamE5GD54lxsKE1SIZlQm%2Fpricing-rule-image-5_1gd4iuh.png?alt=media) #### Combining Conditions Combining conditions allows you to apply actions based on multiple criteria, such as Basket value and custom fields. By using both, you can create highly specific pricing rules that apply only when all selected conditions are met. **Example:** You can set a rule to apply an additional 5% charge if the Basket value is greater or equal than $5,000.00 **AND** the selected delivery type in the custom field is Standard Delivery. By creating a separate group, you can add a rule that applies an additional 10% charge if the Basket value is less or equal than $4,999.00 **AND** the selected delivery type is also Standard Delivery. ![Example of Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FKhGPBJHVM52RP4nb9Z1P%2Fpricing-rule-image-6_1yzdtpy.png?alt=media) #### Actions In the Actions section, you define the outcome when specified conditions are met. The table below outlines the configurable fields: | | Name | Description | | - | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Name | The label displayed to customers during Basket submission, e.g., "Partner Discount" | | | Type | Specifies the type of the adjustment: either **Addition** (an extra charge) or **Discount** (a reduction) | | | Reason | Additional information visible to customers upon hovering, providing context for the adjustment, such as "Enjoy a 10% discount as a thank you for our partnership" | | | Scope | Determines how multiple actions are applied: **All** (applies all actions), **Max** (applies the action with the highest value), or **Min** (applies the action with the lowest value) | | | Mode | Defines the calculation method: **Fixed** (a specific currency amount) or **Percentage** (a percentage of the Basket value) | | | Value | The numerical amount of the adjustment. If Mode is set to Fixed, this is a currency amount; if Percentage, this is a percentage value | | | Add Action Modifier | Allows the addition of supplementary actions to the rule | ![Pricing Rule Actions Settings](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F3aCvmIo2kND24PkX9dCd%2Fpricing-rule-image-7_1rcz1j0.png?alt=media) **Example:** Suppose you want to offer your Core Clients a 10% discount, capped at a maximum of $200. Action Configuration: * Type: Discount * Scope: Min * Action Modifier 1: 10% * Action Modifier 2: $200 In this setup, the system applies a 10% discount to the Basket total. However, if 10% of the Basket value exceeds $200, the discount is limited to $200, ensuring it doesn’t surpass this maximum amount. ![Example of Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FcbOXuMHgxkzkDafiVjhs%2Fpricing-rule-image-8_14tm5up.png?alt=media) Below is a preview of the Basket UI with the configured rule, displaying the Name and Reason fields to the customer during Basket submission. ![Preview of Pricing Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F1DEYomDy1YmVzCyCqjto%2Fpricing-rule-image-9_1ofrfck.png?alt=media) ## How to Search, Delete and Copy Pricing Rules After creating multiple pricing rules, you can efficiently manage them using the **Search** function to find specific rules. Apply **Filters** such as currency and customer scope to narrow down your results. ![Search and Filter Features](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F7i8bBqv1lveTjAmE4adV%2Fpricing-rule-image-10_1yv8hws.png?alt=media) Additionally, the three-dot menu next to each pricing rule offers options to **Delete** or **Duplicate** a rule. The duplicate feature is particularly useful when you need to replicate a rule for a different currency. For instance, if you have a delivery charge rule in USD and want to create the same rule in EUR, simply duplicate the rule, change the currency, and save. ![Duplicate and Delete the Rule](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FgG97xza7AHvKdvYgbly0%2Fpricing-rule-image-11_gnh7ik.png?alt=media) ## Live Demo Preview of Basket with Pricing Rules Before you go live, it’s always a good idea to run a test to ensure everything is working as expected. Once you’re satisfied with the setup, you’ll be ready to start receiving Basket requests. **👀** [**Explore our live demo**](https://codepen.io/mimeeq/live/XWEYQoQ/04205ba63bd5c9337414fad93c39faae)**!** Feel free to submit a Basket to experience the entire process. **Using pricing rules helps you adjust prices to meet your business goals and customer needs. Feel free to reach out to us for assistance. We’re here to help!** 🤝 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.mimeeq.com/commerce-and-integrations/mimeeq-basket/pricing-rules.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.