Documentation
Everything you need to install, set up and get the most out of Ondelab plugins.
Avelio Reviews for WooCommerce
Collect verified customer reviews on your WooCommerce store: automatic email requests, your own review form, moderation and a dashboard. This guide covers installation, every setting and the switch from Customer Reviews for WooCommerce (CusRev).
- Getting started: Requirements · Installation & activation · Quick setup
- Configuration: Review requests · Request email · Review form · Moderating reviews · Displaying reviews · Google Shopping feed · Personal data & legal notice
- Migrating from CusRev: Importing your reviews · Replacing CusRev shortcodes · Removing CusRev
- Help: FAQ · Changelog · Contact support
Getting started
Requirements
- WordPress 6.2 or later
- WooCommerce 7.0 or later
- PHP 7.4 or later
- Compatible with High-Performance Order Storage (HPOS)
Avelio Reviews does not use any external service: there is no account to create and no API key. Emails are sent by your own site, so make sure your site sends email reliably (an SMTP plugin is recommended).
Installation & activation
- In your WordPress admin, go to Plugins > Add New Plugin and search for “Avelio Reviews for WooCommerce”. You can also click Upload Plugin and choose the plugin .zip file.
- Click Install Now, then Activate.
- A Customer reviews menu appears in your admin, right below Comments.
Nothing is sent to your customers until you turn on automatic requests: you can set everything up first.
Quick setup
- Customer reviews > Email: add your logo, set your colours and check the texts in the live preview. Send yourself a test email.
- Customer reviews > Form: adjust the review form your customers will see.
- Customer reviews > Settings: choose the triggering order status, the delay and the sending time.
- Turn on Automatic review requests and save.
- Optional: send a first request by hand from Customer reviews > Requests > Send a request, to an order placed with your own email address.
Configuration
Review requests
In Customer reviews > Settings:
- Triggering order status: the status that starts the countdown (Completed by default).
- Delay before sending: number of days after the order reaches that status (10 days by default).
- Sending time: the hour at which requests go out (10:00 by default), or as soon as the delay is reached.
- Recipients: include or exclude guest orders, limit requests to some product categories, leave out free products, and skip products the customer has already reviewed.
Some rules always apply: each order gets a single automatic request, a scheduled request is cancelled if the order is refunded or cancelled, and nothing is sent to customers who have unsubscribed. Once an order has a review, Avelio no longer offers to resend or send a new request for it.
Requests are scheduled with the WooCommerce Action Scheduler: they go out even without site traffic and are never sent twice. Your site needs a working WP-Cron or server cron, as for any WooCommerce store.
Sending requests by hand
- Customer reviews > Requests > Send a request: pick an order and send right away.
- Orders list: the Reviews column shows the status of each order and offers a one-click send or resend.
- Order screen: the Avelio reviews box shows the full timeline (scheduled, sent, opened, reviewed) with Send now, Cancel and Resend buttons.
Request email
In Customer reviews > Email you can edit the subject, title, text, button label, signature and footer, add your logo and set your colours. Every change shows in the live preview, on desktop and mobile, and you can send yourself a test email.
By default the email is sent from the address used by your WooCommerce emails. You can change the sender name, the sender address and the reply-to address. The list of purchased products can be shown or hidden.
Available variables:
{first_name}and{last_name}: the customer’s billing name{order_number}and{order_date}{shop_name}: your site name{product_list}: the products to review
An optional line “Sent with Avelio Reviews by Ondelab” can be added at the bottom of the email. It is off by default.
Developers can override the template by copying it to your-theme/avelio-reviews/email.php.
Review form
In Customer reviews > Form you set the texts, colours, fonts, star style and corner shape of the form. You can also:
- ask for a shop rating, before or after the products, optional or required;
- make the written review required or optional;
- allow photos (up to 3 per review and 8 MB per photo by default);
- show or hide product prices;
- choose the default displayed name (full name, first name and initial, first name or anonymous): the customer can change it;
- link your terms or privacy page;
- show the form inside your theme (header and footer) or as a standalone page.
The form opens from a personal, secure link in the email: customers do not need an account. The link stays valid for 30 days by default (Settings > Review link validity). The form address is /leave-a-review/ on an English site and /donner-mon-avis/ on a French site; you can change it in Settings > Form address.
Developers can override the template by copying it to your-theme/avelio-reviews/form.php.
Moderating reviews
Moderation is on by default: new reviews wait for your approval, and you receive an email at the notification address set in Settings > Moderation and publishing. Turn moderation off to publish reviews as soon as they are submitted.
In Customer reviews > Reviews you can approve or unpublish a review, reply publicly, feature it or delete it. Reviews are saved as native WooCommerce reviews: they appear on your product pages with the “Verified purchase” badge, count in the average rating and are used by your theme and SEO plugin for structured data.
Displaying reviews
Product reviews show on your product pages as usual. To show reviews elsewhere, use these shortcodes in a page, a widget or your footer (all options are listed in Settings > Display blocks):
[avelio_reviews]: all reviews, with a star summary you can filter and a “Show more” button.[avelio_grid]: a grid of selected reviews (latest, best rated, featured only, from some products…).[avelio_badge]: your average rating and number of reviews, linking to your reviews page.[avelio_reviews_notice]: the notice explaining how reviews are collected.
Google Shopping feed
Avelio can build a product reviews feed in Google’s format, so your star ratings can show in Google Shopping. In Settings > Google Shopping:
- Turn on the feed. Optionally set a minimum review length (10 characters by default) and a default brand for products without a WooCommerce brand.
- Copy the feed address shown on the page.
- In Google Merchant Center, add it as a product reviews feed.
The feed is regenerated every night, or right away with Regenerate now. Products are matched with their GTIN (EAN), SKU and brand from WooCommerce: the settings page tells you how many reviews have neither GTIN nor SKU. Declare a single product reviews feed in Merchant Center, and note that Google applies its own conditions, including a minimum number of reviews.
Personal data & legal notice
- Unsubscribe: every email has a one-click unsubscribe link; unsubscribed customers are kept as a hash of their email address only.
- Email opening: measured with an image served by your own site; you can turn it off.
- Automatic purge: names and email addresses linked to requests are erased after 90 days by default. Published reviews are kept.
- Legal notice: in France, article L111-7-2 of the Consumer Code requires you to explain how reviews are collected. Avelio shows a ready-made, editable notice under your product reviews, and the
[avelio_reviews_notice]shortcode displays it anywhere. - Staging copies: if your site is copied to another address (staging, preproduction), sending is suspended automatically, so customers never receive requests from a test site.
- Uninstalling: reviews are never deleted. Settings and request history are only removed if you turn on Delete settings and history on uninstall.
Migrating from CusRev
If your store used Customer Reviews for WooCommerce (CusRev), Avelio can take over without losing anything and without sending anything twice.
Importing your reviews
- Install and activate Avelio Reviews while CusRev is still active.
- Go to Customer reviews > Settings > Migration from CusRev: Avelio shows what it found (reviews, photos, shop reviews, scheduled reminders).
- Click Run the migration, then Confirm: stop CusRev and migrate the data.
Your reviews stay where they are. The migration links each review to its order, retrieves the photos, imports the send history and the shop reviews, and stops CusRev reminders so that no customer receives two requests.
Replacing CusRev shortcodes
The migration page lists the pages and posts that still use CusRev shortcodes, which stop displaying once CusRev is deactivated. Replace them as follows:
[cusrev_all_reviews]→[avelio_reviews][cusrev_reviews_grid]→[avelio_grid][cusrev_trustbadge]→[avelio_badge]
Removing CusRev
Once the migration is done and your shortcodes are replaced, deactivate CusRev. Check your product pages and your reviews page for a few days, then delete CusRev from the Plugins screen.
Help
FAQ
Do my customers need an account to leave a review?
No. Each email contains a personal, time-limited link that opens the review form directly.
Does Avelio send emails through an external service?
No. Emails are sent by your own WordPress site, from your shop’s address. Use an SMTP plugin if your host does not send email reliably.
What happens to my reviews if I stop using Avelio?
They stay in place: they are standard WooCommerce reviews.
Will my star ratings show in Google?
Your theme and SEO plugin add WooCommerce ratings to your product structured data, which Google can show in search results. For Google Shopping, turn on the product reviews feed.
Can customers stop receiving requests?
Yes, with the unsubscribe link in every email. They will not receive any other request.
Can developers extend Avelio?
Yes. Actions and filters cover the request lifecycle, the email content and variables, the admin screens and the settings.
Changelog
- 1.8.2: dashboard figures counted once per request, follow-ups included; new extension point for the dashboard.
- 1.8.1: no more resend or new request for an order that already has a review.
- 1.8.0: Google Shopping product reviews feed; extension points for follow-up reminders and “review published” emails.
- 1.7.1: optional credit line in emails (off by default).
- 1.7.0: renamed “Avelio Reviews for WooCommerce”, ready for the WordPress.org directory; customers can add several photos one after another.
The full changelog will be available on the plugin’s WordPress.org page.
Contact support
A question or a problem? Email us at contact@getondelab.com with your WordPress, WooCommerce and Avelio Reviews versions and a short description of what happens.
