Arbaint Shopify app guide

Order Tags by Arbaint

User guide for automatically tagging Shopify orders with simple rules. Written for first-time users and does not require any technical knowledge.

Overview

Order Tags by Arbaint watches Shopify order events and adds tags when your rules match. For example, you can tag high-value orders as VIP, tag international orders as International, or tag repeat customers as Repeat.

Important: The app only applies tags when Shopify sends an order event to the app. It does not edit old orders automatically unless Shopify sends a new matching event for those orders.
Screenshot placeholder Dashboard overview inside Shopify admin

Quick start

  1. Open the app from your Shopify admin.
  2. Go to Rules.
  3. Click Create Rule.
  4. Enter a rule name, such as High-value orders.
  5. Enter the tag you want Shopify to add, such as VIP.
  6. Add one or more conditions, such as Order total Greater Than 200.
  7. Keep the rule Active.
  8. Save the rule.
  9. After the next matching Shopify order arrives, open Activity to confirm the tag was applied.

How rules work

Rule

A rule is one automation. It has a name, one or more tags to apply, a status, and conditions.

Tag

A tag is the text added to the Shopify order when the rule matches, such as VIP or Wholesale.

Condition

A condition is the test the order must pass, such as order total, country, product name, discount code, or customer history.

The app avoids adding the same tag again. If a rule matches but the tag is already on the order, the app records the order as skipped instead of adding a duplicate tag.

Dashboard

The Dashboard is the first page you see in the app. It summarizes what the app has done recently.

  • Orders Processed: the number of order processing records in the app.
  • Active Rules: rules that are turned on and can tag new matching orders.
  • Tags Applied: successful tag matches.
  • Getting Started: starter rule templates shown when you have no rules or have not dismissed the section.
  • Recent activity: the latest processed orders, statuses, tags, and times.
  • Plan: your current plan and upgrade action if available.

Starter templates

The Getting Started section can prefill these common rules:

  • High-value orders: order total greater than 200, tag VIP.
  • International orders: shipping country is not US, tag International.
  • Bulk orders: number of products is at least 5, tag Bulk.
  • Repeat customers: customer is not on their first order, tag Repeat.
Screenshot placeholder Dashboard Getting Started template section

Rules page

The Rules page is where you view, search, create, edit, duplicate, pause, activate, and delete automations.

What you can do

  • Create Rule: make a new automation.
  • Search: find rules by name, tag, field, operator, or condition value.
  • Filter by status: show all, active, or paused rules.
  • Filter by tag: show rules that apply a specific tag.
  • Sort: recently updated, name A-Z, name Z-A, newest first, oldest first, or active first.
  • Toggle: activate or pause a rule.
  • Duplicate: copy a rule. Duplicated rules start paused so you can review them first.
  • Delete: hide a rule from future use. Past activity can still show that the deleted rule tagged an old order.
  • Bulk actions: select multiple rules and activate, pause, or delete them together.
Screenshot placeholder Rules list with search, filters, sort, and action menu

Create or edit a rule

The rule builder is the form used for both new rules and existing rules.

Rule details

  • Rule name: a clear internal name, such as “VIP orders over $200”.
  • Tags: the tag or tags to apply when the rule matches.
  • Status: Active means the rule can tag orders. Inactive means it is paused.

Tags

Use short, consistent tag names. Avoid creating many similar tags such as VIP, Vip, and vip customer.

Conditions

Conditions tell the app which orders should receive the tag. Within a group, conditions are joined with AND or OR. If you add more than one group, the groups are joined with OR.

Example

When: Order total is greater than 200 AND Shipping country is US.

Then: Apply tag VIP-US.

Using more than one group

Group 1: Order total is greater than 200 AND Shipping country is US.

OR

Group 2: Customer is not on their first order.

The tag is applied if either complete group matches.

If you change a rule, it affects future order events only. It does not automatically retag orders that were already processed.
Screenshot placeholder Create Rule page showing name, tags, status, and conditions

Condition reference

Choose a field, choose an operator, then enter a value if the operator needs one. Text checks are case-insensitive, so vip and VIP are treated the same for matching.

Operators

OperatorPlain-English meaningNeeds a value?
EqualsThe field must be exactly this value.Yes
Not EqualsThe field must be different from this value.Yes
ContainsThe field must include this text.Yes
Does Not ContainThe field must not include this text.Yes
Starts WithThe field must begin with this text.Yes
Ends WithThe field must end with this text.Yes
Greater ThanThe number must be higher than your value.Yes
Less ThanThe number must be lower than your value.Yes
At LeastThe number must be equal to or higher than your value.Yes
At MostThe number must be equal to or lower than your value.Yes
Is EmptyThe field has no value.No
Is Not EmptyThe field has any value.No

Available fields

Order fields
  • Order total: final order total.
  • Order subtotal: product subtotal before shipping and discounts.
  • Total discount amount: total discount value on the order.
  • Shipping cost: shipping amount.
  • Number of products in order: number of line items.
  • Total items ordered: sum of item quantities.
  • Total order weight (g): order weight in grams.
  • Order currency: currency code, such as USD, EUR, or IDR.
  • Payment method: gateway such as Shopify Payments, PayPal, manual payment, Apple Pay, or another gateway name.
  • Payment status: pending, authorized, paid, partially paid, refunded, voided, or expired.
  • Fulfillment status: unfulfilled, partial, or fulfilled.
  • Discount code: discount code used on the order.
  • Sales channel: source such as web, POS, draft order, iPhone, Android, or API.
  • Tags on order: tags already on the order before this app adds new ones.
  • Fraud risk: low, medium, or high risk from Shopify risk data.
  • Note on order: text from the order note.
Shipping fields
  • Shipping country: country code from the shipping address, such as US or ID.
  • Shipping state/province: province or province code.
  • Shipping city: city from the shipping address.
  • Shipping method: shipping line title, such as Standard or Express.
Product fields
  • Product name: product title on any line item.
  • Product SKU: SKU on any line item.
  • Product vendor: vendor on any line item.
  • Variant name: variant title on any line item.
  • Product type: product type on any line item.
  • Tags on product: product tags fetched from Shopify.
  • Custom field on product: product metafields fetched from Shopify.
Customer fields
  • Is this the customer's first order? yes or no.
  • Customer order count in the last 7, 14, or 30 days: recent order count including the current order.
  • Customer total spend in the last 7, 14, or 30 days: recent spend including the current order.

Product metafields

If your store has product metafield definitions, the rule builder can show them as selectable custom fields. The generic custom field format is namespace.key=value, for example custom.material=cotton. For Is Empty or Is Not Empty, use only namespace.key.

Some condition fields use a structured value, such as an amount with a currency or a measurement with a unit. Use the value and unit/currency inputs shown by the rule builder rather than typing them as plain text.

Activity

The Activity page shows orders the app processed and whether tags were added or skipped.

Statuses

  • Tagged: at least one tag was added to the Shopify order.
  • Skipped: no tag was added. Common reasons are no rules matched or the tag was already present.

Filters

  • Search: search order, rule, or tag.
  • Status: all, Tagged, or Skipped.
  • Tag: filter by a tag that has been applied before.
  • Time: all time, today, or this week.

Activity detail

Click an activity row or the View action to open more detail:

  • Order number and status.
  • Link to open the order in Shopify admin when available.
  • Total, currency, payment status, and fulfillment status.
  • Matched rules, tags, and conditions.
  • Skipped reason, when the order was not tagged.
Screenshot placeholder Activity page with search, filters, statuses, tags, and View action
Screenshot placeholder Activity detail modal showing matched rules and skipped reason

Plans and limits

You can view or change your subscription from Plan in the app navigation.

PlanPriceIncluded
Free$0/month1 automation rule and up to 30 orders per month
Basic$7.99/monthUp to 10 automation rules and unlimited monthly orders
Unlimited$14.99/monthUnlimited automation rules and unlimited monthly orders

Basic includes advanced conditions and real-time processing. Unlimited includes priority processing and priority support. The Free plan includes basic conditions and email support.

When you downgrade, rules beyond the new plan's limit stop processing new orders. Review your active rules before confirming a downgrade. Shopify handles subscription billing and confirmation.

To get help, open Support in the app navigation and send a message with the affected order number or rule name. Include what you expected to happen and what you saw in Activity.

Troubleshooting

My order was not tagged
  • Make sure the rule is Active.
  • Confirm Shopify sent an order update that the app can process.
  • Open Activity and check whether the order was skipped.
  • Review the rule conditions and compare them with the real order details in Shopify.
  • Check whether the tag was already on the order before the app tried to add it.
The rule says a condition is invalid
  • Edit the rule and reselect the field and operator.
  • For numbers, use digits only, such as 200 or 200.50.
  • For whole-number fields, use values like 1, 5, or 10.
  • For product metafields, use namespace.key=value.

FAQ

Will the app tag old orders?

No. The app checks active rules when Shopify sends an order update that it processes. Old orders are not automatically scanned.

Can one order receive multiple tags?

Yes. If several active rules match, the app applies the unique set of matching tags.

Can I pause a rule without deleting it?

Yes. Set the rule status to Inactive or use the toggle on the Rules page.

How do multiple conditions work?

Conditions in one group follow the AND or OR setting shown in the rule builder. Multiple groups are joined with OR, so a match in any complete group can apply the tag.

What happens if I reach my plan's limit?

The app will not process orders beyond the plan's monthly order limit, or rules beyond the plan's rule limit. Upgrade from the Plan page to increase the limit.

What happens if I delete a rule?

The rule stops showing in the Rules page and will not process future orders. Past Activity can still show the deleted rule for historical accuracy.

Why do product tag and metafield rules need Shopify data?

Shopify order webhooks do not include every product tag or metafield. The app fetches that data from Shopify only when an active rule needs it.