Shopify metafields and Shopify Flow

A2Reviews writes review data to your Shopify products and connects to Shopify Flow, so you can use review data outside the reviews widget.

Product metafields

Each time a product's reviews change, for example after an import, an edit or a new customer review, A2Reviews updates metafields on that Shopify product. They use the a2reviews namespace:

A theme developer can use them in Liquid, for example to show a rating on a custom section:

{{ product.metafields.a2reviews.avg_rating }} ({{ product.metafields.a2reviews.total_rating }} reviews)

If you set a custom review total for a product in A2Reviews (Customize total reviews), the metafields use that value. If you group products as parent and child, the combined numbers are used.

Tip: If a metafield looks out of date, open the product in A2Reviews and use Clear cache and refresh, or save a change to its reviews to push the data again.

Shopify Flow

A2Reviews works with Shopify Flow in two ways.

Trigger: new review

Start a Flow workflow when a new review is submitted. The trigger sends the product ID, rating, title, content, author, email, country code, and whether the review has images or video (including the number of images). You can use these in conditions, for example "if the rating is 2 or lower, send an internal email" or "tag the customer when they leave a 5-star review with photos".

The trigger only fires for reviews that include a valid email address, an author name and a product.

Action: send a review request

Add the A2Reviews action to a workflow to send a review request email for an order. The action needs the order ID. A2Reviews sends the request only for orders it has already synced from your store. The email uses your Reviews Request settings and email templates.

Set up a workflow

  1. Open the Shopify Flow app in your Shopify admin and create a workflow.
  2. Select the A2Reviews trigger, or add the A2Reviews action after a trigger such as an order event.
  3. Add your conditions and actions, then turn the workflow on.