Post Purchase Form

The post-purchase review form is served as a native Shopify metaobject page - fully rendered server-side in Liquid, no app proxy involved.

How it works

When the app sends a review request email, the link points to a Shopify page at:

https://{your-store}/pages/fo-review-request/{handle}

Each link is unique to a specific order and customer. Shopify renders that URL using your theme’s metaobject template for review_request objects, where the FiveOh Post Purchase Form block must be present.

The form reads order and customer context directly from the metaobject (customer name, ordered items, product images). On submission the metaobject handle is passed as the identifier so the app can resolve the original request and mark the review as verified.

Setup

1. Open the Theme Editor.
2. Navigate to Templates → metaobject.review_request (create it if it doesn’t exist yet).
3. Add the FiveOh Post Purchase Form section block to that template.
4. Save.

Once the block is on the template, any review request link the app sends will render your themed form server-side.

What you can customize

All content and layout is controlled through the block settings in the Theme Editor:

• Heading text
• Star color and size
• Labels and placeholders for rating, title, body, media upload, and author fields
• Submit button text, submitting/submitted states, success and error messages
• Form structure (structure, form_item_structure) and custom CSS

Notes

• The block only renders when the page metaobject is of type review_request. It is safe to add to the template without side effects on other metaobject types.
• The FiveOh Core app embed’s noindex setting also applies to these pages, keeping them out of search results.
• Review link generation is handled automatically by the post-purchase email feature - no manual URL construction needed.

Troubleshooting

• If the page is blank, confirm the block is added to the metaobject.review_request template and saved.
• If the form renders but context is missing (no product names/images), verify the review request metaobject was created correctly for the order.
• If customers report broken links, check that the review request email feature is enabled and that a metaobject was created for the relevant order.