# Trigger Rules

### Trigger Rules

An event that starts an automation flow, based on customer events and cart activity&#x20;

The Trigger enables users to verify whether customer contacts that meet the trigger event criteria will enter automation.

This tool ensures your automation is correctly configured by demonstrating whether the trigger and audience filters are operating as expected.

### Types of Trigger Conditions

> <mark style="color:orange;">Order total</mark>
>
> <mark style="color:orange;">Language</mark>
>
> <mark style="color:orange;">Currency</mark>
>
> <mark style="color:orange;">User roles</mark>
>
> <mark style="color:orange;">Category Name</mark>
>
> <mark style="color:orange;">Category IDs</mark>
>
> <mark style="color:orange;">Product name</mark>
>
> <mark style="color:orange;">Product ID's</mark>
>
> <mark style="color:orange;">Variant ID's</mark>
>
> <mark style="color:orange;">Buyer Accepts Marketing</mark>
>
> <mark style="color:orange;">Geolocation</mark>
>
> <mark style="color:orange;">Placed order</mark>

### Use Case

> #### 1. **Order Total**
>
> * **Use Case:** Trigger an automation for customers whose order total meets a certain threshold (e.g., > $100). This could be useful to send personalized thank-you emails, loyalty rewards, or special discounts to high-spending customers to encourage future purchases.
>
> #### 2. **Language**
>
> * **Use Case:** Tailor emails and content in the customer’s preferred language based on their browser or previous interactions. This ensures a personalized experience and can help boost engagement and conversion rates.
>
> #### 3. **Currency**
>
> * **Use Case:** Trigger region-specific pricing or promotions. For example, if a customer is browsing in GBP, show them offers that are most relevant to the UK or offer free shipping for orders in that region.
>
> #### 4. **User Roles**
>
> * **Use Case:** Segment emails based on user roles such as “New Customer,” “VIP,” or “Wholesale.” For instance, send VIP users exclusive offers or reward programs, while new customers could receive a welcome discount.
>
> #### 5. **Category Name**
>
> * **Use Case:** Trigger specific automations based on the product category a customer interacts with. For example, customers browsing "Electronics" could receive recommendations for complementary products like chargers or cases.
>
> #### 6. **Category IDs**
>
> * **Use Case:** Automate follow-up emails for customers who have purchased items from certain categories (by ID). If a customer purchases from a "Skincare" category, send skincare-related tips, product recommendations, or refill reminders.
>
> #### 7. **Product Name**
>
> * **Use Case:** Create targeted post-purchase follow-ups or pre purchase automations for specific products. For example, after purchasing a "Yoga Mat," the customer could be sent offers for yoga accessories or a wellness subscription plan.

> #### 8. **Product ID**
>
> * **Use Case:** Create targeted post-purchase follow-ups or pre purchase automations for specific products. For example, after purchasing a "Bluetooth Speaker," the customer could be sent offers for related accessories like speaker stands or headphones.
>
> #### 9. Variant ID
>
> * **Use Case:** Tailor post-purchase emails based on the specific variant a customer purchased. For example, if a customer buys a "Red T-shirt" in a specific size, they could receive offers for similar shirts in different colors or matching accessories.
>
> #### 10. Buyer Accepts Marketing
>
> * **Use Case:** Send marketing emails or exclusive offers only to customers who have opted in for communications. For example, after a customer accepts marketing, you could send them personalized discounts, promotions, or updates about new products.
>
> #### 11. **Geolocation**
>
> * **Use Case:** Personalize marketing messages based on the customer's location. For instance, offer discounts on warm clothing to customers in colder regions or showcase products that are popular in their area.
>
> #### 12. **Placed Order**
>
> * **Use Case:** Trigger post-purchase workflows, such as thank-you emails, product review requests, or loyalty reward notifications. This can enhance customer satisfaction and foster repeat purchases.

**Order total**

Triggers emails based on the total amount of a customer's order.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcQaEXp82qnx8qPlvgmuvdWv0sDLTeGIjzif-RLfkDIF0oSVeDhkNxke1yjkBCWJ9D1MpyEph4gL5P9Ywj3fhZyl-q1W5lhbZCdDUpFxYMJ3nVTatmbVf1yAGqnEX0WZcQ9EpS7cR6GxuMrJ8DIOxSokQa7?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Order Total</p></figcaption></figure>

#### Language

Sends emails in the customer's preferred language

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcTA7tjifQFV8Se_JPwxw89gbNgMb6toTRMlSbA_w_Tz2TAZzhNQKup58PqvN4-S2op55y60zS3stwp8idtTSBsrnS7qh70gjrJn83_hVqZ9ASjZyXqKlV47BSb7Yl87Jir5t_vS1tuxDl9VoiHY0-9gMnZ?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Language</p></figcaption></figure>

#### Currency

Sends emails in the user's preferred currency into the automation

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfCbbHUPiS3UCr-OJ6_ZLRSacGzlTvtn1rg3bhAoq0u1EGN2HC9_cyDwWleMCCzsj3RbzS8OzkzioyjcS3LUUZttl531cTUV8_y1kny8gtXV-egPdInw-dhlTMhy1FehRgYkpTt4U1M4kJE0VvgfQ13tPk?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Currency </p></figcaption></figure>

#### User Roles

Administrators or staff members of the store, allowing them to test and manage automated workflows.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXciga9m1740ZgrJalGAuf0QrN8MB1N1w3E6S3ODstPlc2oRIPeYYHGVMq6UeUtBwAgtC91LFJ508ddTvKW9H16Ad7WUNhXRFY9xWrwBEuPE_f9aPVaGJjFoh43nYhTsuOBsfJdcSyc439F9o3KKA4kO6yHu?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>User Roles</p></figcaption></figure>

#### Category Name

Sends specific emails based on the product category the customer interacted with.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf49rffSjaaJIU9aQTCNBZ5r-P2sQJj22DSKKwIF4mVwxXONQEQZMV72Q4uG5WNWuZp7j4uEGWgFnQrBfc0UD9Msq9KmkIbUdaeL31ZeEsWUeipBXMGza-TzBQqt_4KTmUiBxS2_ZNdbMfOGcIozVZuWELL?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Category Name</p></figcaption></figure>

#### Category IDs

Sends specific emails based on the product category IDs the customer interacted with.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfaounMHpw5Z4PAh2eqPGvKJreBXZ3PzKs9NS8wThUv_wUZg7Gno9mBugEtsXCe6L7X4gFHWgae73QUSRwFQZXhxCiiYxrNVkwlLkmvVIjPR6BUmcrKxMOHs3B-QDImPeYUxtRQPujbwqMz1fegRjud0w5C?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Category ID</p></figcaption></figure>

#### Product names

Triggers emails for certain product names a customer views or buys.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcyvnWSrxXm2ycnc155XWDkiJc2Rk93uf3D1IAjVoDJVUIEjZSQnr-LYDm46d5r6pIgIGtL6dsw7iZXCH-gpfU0DE6qy0OLCw_UFpvkHobYHnRnbpgB9VlZSWOw_J5oSDWVjxk55IUvZS4xhWmCCz9A_ps?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Product Names</p></figcaption></figure>

#### Product IDs

Triggers emails for certain product IDs a customer views or buys.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXebmI62JXekcNh4wNoRwlDKfwLWudYwq1Hx8HeuGvA-XqrJBZnllnGl0j4kBP4LlT42PZDJbksaYm8RxU0qwvQKXfUsEWD68Bmt99HWzosO9Drvxdg3b-bW9bC2DBr-SKXoQr68QxdBhENfkDQWvNxTJAn-?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Product ID's</p></figcaption></figure>

#### Variant ID

Triggers emails based on the product variant the customer interacted with, such as selecting a particular size, color, or style.

<figure><img src="/files/fr2f8fdEf9DeprUousG1" alt=""><figcaption><p>Variant ID</p></figcaption></figure>

#### Buyer Accept marketing

Sends emails only if the customer has agreed to receive marketing emails.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXet-ih-MhHWbYRgeCWU3544v636UkbDhgWLfAaXXFEkHWiYmJYxFY1OxJ26s6iehp1PBN31Wzijq0L_sf1TBqf7U_H1SjGdgtqb4_tayyS9Dhcof0SOMC71s4nW4esQtx5gn8k9AFh-ZT7YIN9uQ_5ZiJce?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Buyer Accept Marketing</p></figcaption></figure>

#### Geolocation

Uses the customer's location to send an email.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf7tPJlxMHBZA-hzpXrcGtb-MdzdYzBCcLtI8NC72riTVqmjVaMkyzxexUqFZgy6N6mHoIgJF0ABUxUw_PY5zEuoII0_7ySlXnuqaMnbtdfVCRzvaJjBXd4YlRgPiRY4Ni7gE3G-1mGguN8IkbKMpWm0dcy?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Geolocation</p></figcaption></figure>

#### Placed order

Triggers a follow-up email once a customer completes a purchase.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc2vathvC2ii0gkqcgFrJNZUIoSP_IG5eBP50NOOjJ0Xl71VJ0wpwdvu96ouF8Rdnj8Y4jGTOUuIVOYZv99E4jqG1AcbaR9MGxCJPUTgWZnREnUfGBuUWGEJV9Ak0gZMqCAZVdVDOY2guOF8yFaG3rNynBt?key=Ho1iXyq1YhqmnJh0kGHBTFh6" alt="" width="375"><figcaption><p>Placed order</p></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://help.retainful.com/automations/automation-workflow-settings/trigger-rules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
