Core Concepts
Techniques
Tagging Shopify resources
Merchants commonly use Mechanic for adding or removing tags from customers, orders, products, and other Shopify resources.
When writing your task scripts, use a Shopify action to add or remove tags via the Shopify API. There are two usages available: one using GraphQL, and one using the REST API.
GraphQL
This is the recommended usage, because – unlike the REST API – it allows for tags to be individually added and removed, without any risk of interfering with simultaneous tagging operations.
Because the permission required varies based on what you're tagging, make sure to render a representative node ID during preview mode to avoid "TagsAdd access denied" errors. In this approach, we use stub data to create dynamic preview actions.
1
{% if event.preview %}
2
{% capture customer_json %}
3
{
4
"admin_graphql_api_id": "gid://shopify/Customer/12345"
5
}
6
{% endcapture %}
7
8
{% assign customer = customer_json | parse_json %}
9
{% endif %}
10
11
{% action "shopify" %}
12
mutation {
13
tagsAdd(
14
id: {{ customer.admin_graphql_api_id | json }}
15
tags: ["some", "new", "tags"]
16
) {
17
userErrors {
18
field
19
message
20
}
21
}
22
}
23
{% endaction %}
24
25
{% action "shopify" %}
26
mutation {
27
tagsRemove(
28
id: {{ customer.admin_graphql_api_id | json }}
29
tags: ["tags", "to", "remove"]
30
) {
31
userErrors {
32
field
33
message
34
}
35
}
36
}
37
{% endaction %}
Copied!
Logging the results
The one drawback is that using GraphQL does not automatically log the results of a tagging operation, whereas REST does. However, it's easy to include the final tags for a resource, in the results of your GraphQL mutation – very useful for proving that your mutation is doing what you expect, and also for allowing you to refer back to the current tagged state of the resource.
1
{% action "shopify" %}
2
mutation {
3
tagsAdd(
4
id: {{ customer.admin_graphql_api_id | json }}
5
tags: ["some", "new", "tags"]
6
) {
7
node {
8
... on Customer {
9
tags
10
}
11
}
12
userErrors {
13
field
14
message
15
}
16
}
17
}
18
{% endaction %}
Copied!
Note the triple dots: the
... on <TYPE> syntax marks an inline fragment. Replace "Customer" with the name of the GraphQL type you're working with (e.g. "Product", or "Order). Read more from Shopify: GraphQL / Advanced Concepts / Inline Fragments.REST
This approach is also viable, but has one risk: because it specifies all of the tags at once that the customer should have, it's possible to overwrite tags that some other task or app has added.
1
{% action "shopify" %}
2
[
3
"update",
4
["customer", {{ customer.id | json }}],
5
{
6
"tags": {{ customer.tags | add_tag: "approved" | json }}
7
}
8
]
9
{% endaction %}
Copied!
1
{% action "shopify" %}
2
[
3
"update",
4
["customer", {{ customer.id | json }}],
5
{
6
"tags": {{ customer.tags | remove_tag: "approved" | json }}
7
}
8
]
9
{% endaction %}
Copied!
These examples use
add_tag and remove_tag, which are Liquid filters unique to Mechanic (see Mechanic's list of supported filters).Last modified 8mo ago
Copy link
Edit on GitHub