Custom query for filter in Get Customer Data action

Topic summary

A user needed to filter customers by tag in Shopify Flow’s Get Customer Data action but struggled with the correct query syntax.

Attempted solutions that failed:

  • query=tags:EdTest
  • tags:EdTest
  • tag=EdTest
  • query=tag:EdTest

The user referenced Shopify’s GraphQL API documentation on filter parameters, which indicated tag filtering should be possible, but couldn’t determine the proper syntax from the documentation alone.

Resolution:
The correct syntax is tag:EdTest (without the “query=” prefix and using singular “tag” with a colon). This successfully filters the customer list to show only those with the specified tag.

Note: Some responses suggested private consultation rather than public solutions, which the original poster rejected in favor of keeping answers accessible to the community.

Summarized with AI on November 2. AI used: claude-sonnet-4-5-20250929.

I need to filter the list of customers returned by the Get customer data action according to whether a customer has a specific tag. I have tried the syntax

query=tags:EdTest

and all variations that I can think of; but nothing filters the list successfully.

According to the documentation on filter parameters shown here, I ought to be able to do this somehow. What am I doing wrong?

Can’t you explain the solution here so that everyone else can benefit as well?

Thank you for your reply. As per my original question, I’m interested in scenario #3. In particular, I want to know how to craft a custom query for a filter in the Get Customer Data action. Please see the screenshot(s) in my question above for more details.

This is a community forum: questions are asked and answered for the benefit of everybody; therefore the replies need to be public. If you are unwilling to offer your help under these conditions, please don’t respond any further - there are more appropriate ways to advertise private consultancy services.

Thank you for your reply. However, as explained in my original question, I have already tried to adjust the filters directly in the action settings - but without success. Please see the first screenshot in my question above. I have tried tag:Edtest, tags:Edtest, query=tag:Edtest and query=tags:Edtest in the action settings; but none of these filters my list of customers according to the presence of the tag “EdTest”, which is my aim.

I finally cracked it! Turns out I was wrong in my last post: I had tried tag**=**EdTest but not tag:EdTest, which turned out to be the right answer!