Order Sync can automatically add tags to Mautic contacts based on the products they purchase. Tags help you segment contacts for targeted campaigns and automations. This page explains each tagging option and how tags accumulate over time.
Product Name Tags
The Add product/status tags to contacts setting is enabled by default. When active, the plugin creates a tag for each product in the order using the product SKU (or product name if no SKU is set) combined with the order status.
For example, if a customer buys a product with SKU “TEE-BLU-M” and the order is completed, the contact receives the tag:
tee-blu-m_completedIf the product has no SKU and is named “Classic Cotton T-Shirt”, the tag becomes:
classic-cotton-t-shirt_completedTag names are sanitized to lowercase with hyphens, following the WordPress sanitize_title format.
Product ID in Tags
The Include product ID in tag names setting is disabled by default. When enabled, the product ID is prepended to the product name in the tag. This is useful if you have multiple products with similar names and need to distinguish between them.
For example, product ID 47 named “Classic Cotton T-Shirt” with no SKU would produce the tag:
47_classic-cotton-t-shirt_completedNote that this setting only applies when a product does not have a SKU. Products with a SKU always use the SKU as the tag base regardless of this setting.
Category Tags
The Add product category tags setting is disabled by default. When enabled, the plugin adds a tag for each WooCommerce product category assigned to the purchased products.
For example, if a product belongs to the “Clothing” and “Sale” categories, the contact receives these tags:
clothing
saleCategory tags do not include the order status. They represent the product category in a simple, lowercase format. This lets you segment contacts by the types of products they buy rather than individual products.
General Tags
The General Tags field lets you enter a comma-separated list of tags that are applied to every contact when an order syncs. These tags are added regardless of what products are in the order.
For example, entering customer, woo-buyer in this field means every contact who places a synced order gets both the “customer” and “woo-buyer” tags.
General tags are useful for broad segmentation, such as identifying all contacts who have made at least one purchase from your store.
How Tags Accumulate
Tags in Mautic are additive. Each synced order adds its tags to the contact, but existing tags are never removed. Over time, a contact builds up a history of tags reflecting all of their purchases.
For example, a customer who buys a t-shirt (completed), then later buys shoes (completed), and then gets a refund on the shoes would have all of these tags:
tee-blu-m_completed
running-shoes_completed
running-shoes_refunded
customerDuplicate tags are automatically filtered out. If a contact already has a tag, it is not added again.