Review Requests
Version0.8.0
Compatibility^3.0.0
Categorymarketing-seo
Downloads1.3K monthly
Last updatedAug 4, 2026
Automated post-purchase review invitations for Vendure, timed off your order dates. Sends a branded, Trustpilot-style email that links to your free Trustpilot review page — no paid Automatic Feedback Service required — and can show your live star rating pulled from the free Trustpilot API.
Plugin page & pricing: https://huloglobal.com/vendure-plugins/review-requests/
What it does
- Timed off order dates. An hourly worker finds orders that reached a trigger state (Delivered / Payment settled / Shipped) N days ago and invites the customer to review you.
- Free Trustpilot, done right. The review button links to
https://www.trustpilot.com/evaluate/<your-domain>(organic Service Reviews, free). Optionally add a free Trustpilot developer API key and the email shows your live TrustScore + review count as social proof. The link template is configurable, so you can point at Google reviews or anywhere else instead. - Exclusions. Never invite specific emails or whole domains (wholesale accounts, staff). One-click unsubscribe in every email auto-excludes.
- No spam. Deduped per order, plus a per-customer cooldown (default 120 days) and a minimum order value.
- Editable email with live preview + test-send, per channel.
- Multi-tab admin: Overview (sent / eligible / opt-outs / failed, live rating), Settings, Email, Exclusions, Activity log.
Install
Ts
Admin UI:
Ts
Then open Review requests in the admin, set your Trustpilot domain, timing and email, hit Send test, and switch the channel on.
Getting your Trustpilot bits (all free)
- Review link — nothing needed; it's just
evaluate/<your-domain>. - Live rating (optional) — register a free app at https://developers.trustpilot.com/ for an API key, put it in Settings, and click Check rating (the plugin finds your business-unit id from the domain).
Configuration (per channel)
| Setting | Default | Notes |
|---|---|---|
| Trigger state | Delivered | Delivered / Payment settled / Shipped |
| Delay (days) | 14 | days after the order date |
| Min order value | 0 | skip low-value orders |
| Cooldown (days) | 120 | don't re-ask the same customer |
| Max per run | 200 | hourly throttle |
| Review link template | Trustpilot evaluate URL | {domain} is substituted |
Licensing
Free tier: configure, preview and test-send. Scheduled sending requires a licence from https://huloglobal.com/vendure-plugins/review-requests/.
Compatibility
Vendure >=3.5 <4. MySQL / MariaDB. Tables are created on boot. Sends via your
SMTP (SMTP_SERVER / SMTP_PORT / SMTP_USER / SMTP_PASSWORD / SMTP_FROM,
or pass smtp to init()).
License
AGPL-3.0-or-later — commercial licences available from HULO Global.
Changelog
All notable changes to @huloglobal/vendure-plugin-review-requests are documented
here. Format: Keep a Changelog; this project
follows semantic versioning.
[0.8.0] — 2026-08-04
Added
- Upload image / asset library. A new toolbar button opens Vendure's asset picker — browse the library or upload a new image — and inserts it into the email. Images are stored in your Vendure asset library like any other asset. The previous insert-by-URL button stays. Editor selection is now saved/restored so toolbar and colour actions apply reliably even after a dialog opens.
[0.7.0] — 2026-08-04
Added
- Full editor toolbar: text + highlight colour, font size, underline/ strikethrough, headings/subheadings/quotes, numbered lists, indent/ outdent, image insert (by URL, alt text), a custom button, horizontal divider, left/centre/right align, clear-formatting and undo/redo.
Fixed
- Editor text showed grey in dark mode: the admin theme was colouring bare block elements. Canvas content now forces its own dark ink on the white paper (inline colours in your HTML still win).
[0.6.1] — 2026-08-04
Fixed
- Dark mode: the visual editor canvas now reads as an intentional white "paper" (framed, with a visible caret + selection) instead of a bare white block, and the email preview renders on white to match how the email actually looks.
[0.6.0] — 2026-08-04
Added
- Visual email editor. The invitation email now has a WYSIWYG editor with a formatting toolbar (bold, italic, heading, lists, links, a one-click review button, alignment), drag-and-drop variable chips (drop {{firstName}}, {{productList}}, etc. anywhere), and a Visual / HTML toggle so you can drop into raw HTML whenever you want. Live preview + test-send unchanged.
[0.5.0] — 2026-08-04
Added
- Product reviews. A new "What to ask for" mode — Store review / Product reviews / Both. In product (or both) mode the email lists the actual products from the customer's order, each with its own "Review this" button linking to your storefront's product-review page (a configurable link template with {slug}, {name}, {orderCode}). Works alongside the Trustpilot/Google store review. New template variables {{reviewButton}} and {{productList}}.
[0.4.0] — 2026-08-04
Added
- Google reviews live rating. Pick Google in the platform selector, add a Google Maps API key (Places API) + your Place ID, and Connect — the email now shows your live Google star rating + review count, the same way Trustpilot does. Both platforms cache for 6h and fail open.
[0.3.0] — 2026-08-04
Added
- Live customer search in Exclusions. Type a name or email and pick a real customer to exclude — each result shows whether they're already excluded (and why: excluded / domain rule / unsubscribed), so it doubles as a quick "is this customer excluded?" check.
- Review-platform picker. Choose Trustpilot / Google reviews / Reviews.io / Custom and the review link is built for you (Trustpilot keeps the live-rating auto-detect; the others use the link only). Any site with a review URL already worked via the template — this makes it one click.
- Endpoints:
GET /review-requests/customers/search,GET /review-requests/exclusions/check.
[0.2.0] — 2026-08-04
Changed
- Simpler setup. The Settings tab now opens with a one-click Connect Trustpilot: enter your domain (and an optional free API key) and the plugin auto-detects your business-unit id and pulls your live star rating — no manual lookups. Just a domain, a business name and "days after order" are on the main screen; everything else moved behind an Advanced toggle.
Added
POST /review-requests/trustpilot/detect— resolve review link + business-unit id + live rating from a domain (+ key) in one call.
[0.1.0] — 2026-08-04
First release.
Added
- Order-date-timed review invitations. Hourly worker invites customers whose order reached a trigger state (Delivered / PaymentSettled / Shipped) a configurable number of days ago.
- Free Trustpilot integration. Review button links to the free
trustpilot.com/evaluate/<domain>page (organic reviews, no paid AFS). Optional free Trustpilot API key reads the live TrustScore + review count to show as social proof in the email. Link template is configurable (Google, etc.). - Customer exclusions by email or domain, plus signed one-click unsubscribe that auto-excludes.
- Dedup + cooldown + minimum order value so nobody is over-asked.
- Editable email template per channel, with live preview and test-send.
- Multi-tab admin dashboard (Overview / Settings / Email / Exclusions / Activity) on the HULO design system, with a send log and eligibility preview.
- HULO licence SDK: free tier = configure + preview + test-send; scheduled sending is licensed. Admin REST requires an authenticated admin session.