Gatemi Review Reminders Settings Reference

Both editions have one screen: WooCommerce → Review Reminders (capability manage_woocommerce). Both store their settings in one option, gmrr_settings. The free edition saves only its own fields and carries every other key through untouched, so nothing the full edition wrote is lost when you switch.

The screen opens with What is checked before a reminder goes, a short reminder of the rules in How it works.

When to ask

Send review reminders

  • Key: enabled · Default: on (yes)
  • Off, no reminder is sent and the hourly cron event is removed.

Count from the moment an order reaches

  • Key: status · Default: completed
  • A drop-down of your store's order statuses. Only orders that are in this status when the sweep runs are asked — an order that has since moved to Refunded or Cancelled is not.
  • In this version the days below are measured from the date the order was placed (WooCommerce's order date), not from the moment it reached the status. On a shop that completes orders the day they ship, set the days to cover delivery time as well.

Ask after (days)

  • Key: reminders[0][days] · Default: 7 · Range: 0–365
  • 0 means as soon as the order is in the chosen status.

Subject

  • Key: reminders[0][subject] · Default: empty, sent as "How did you get on with your order?"

Message

  • Key: reminders[0][body] · Default: empty, sent as:

    Hello {first_name}, You bought {products} from {site_title} a little while ago. If you have a minute, we would love to know how you are getting on with it. Leave a review (linked to {review_url})

  • The message is HTML email; it keeps the markup a post may contain.

Placeholders in the subject and the message:

Placeholder Replaced with
{first_name} The billing first name
{order_number} The order number
{products} The names of the products being asked about, separated by commas
{site_title} Your site title
{review_url} The signed review link for this order
{shop_url} Your shop page

A placeholder that has no value becomes nothing, never the literal {first_name}. An unsubscribe line is always added to the end.

More reminders — Full edition

The full edition shows every reminder as a row with its own Ask after (days), Subject and Message, and Add another reminder adds a row. Reminders are sent in order of their days. Below them, a sentence reads the sequence back to you, for example "As it stands, a customer would hear from you: 7 days later, then 21 days later."

The screen always shows one blank row after your reminders, pre-filled with 7 days. It is saved like any other row, so read that sentence after pressing Save changes and make sure it lists only the reminders you meant.

In the free edition: if the full edition wrote more than one reminder, they are all kept exactly as they are and the screen says so; the free edition sends the first.

Photos

Let customers add a photo to a review

  • Key: photos · Default: on (yes)
  • Adds a photo field to the product's own review form. Accepted types are JPG, PNG, GIF and WebP, checked against the file itself. Photos show once the review is approved.
  • Free edition: one photo per review, up to 4 MB.

Photos per review — Full edition

  • Key: photo_max · Default: 3 · Range: 1–10

Largest photo (MB) — Full edition

  • Key: photo_size · Default: 4 · Range: 1–16
  • The free edition never accepts more than 4 MB; a smaller size the full edition set is respected.

Who to leave alone — Full edition

Never ask about these products (ids)

  • Key: exclude_products · Default: empty
  • Product ids separated by commas or spaces, for example 12, 34.

Never ask about these categories (ids)

  • Key: exclude_terms · Default: empty
  • Product category ids. Sub-categories count too.

Gift cards and services are the usual answer here. An order whose every product is excluded is not asked at all.

In the free edition: exclusions the full edition saved are still applied. An exclusion only ever asks for less, so it is honoured rather than dropped.

A thank-you coupon — Full edition

Send a single-use coupon when a review is approved

  • Key: coupon · Default: off (no)

Worth

  • Key: coupon_amount · Default: 10 (whole number, at least 1)
  • Key: coupon_type · Default: percent — percent off, or off the cart (fixed)

Valid for (days)

  • Key: coupon_days · Default: 90

The coupon is created when a review is approved, never when it is submitted, so an unmoderated review earns nothing. Its code looks like REVIEW-AB12CD34; it is restricted to the reviewer's email address, can be used once, cannot be combined with other coupons, and expires the set number of days after it is created. Its description reads "Thank-you coupon for review #…", so you can find it under Marketing → Coupons. In this version the coupon is created and recorded on the review, but no email is sent with it. The code is stored on the review as comment meta _gmrr_coupon (see the developer reference); send it to the customer yourself.

Wording — Full edition

Send reminders as

  • Key: from_name · Default: empty (WordPress's own sender)
  • Sets the sender name; the address is your site's admin email.

Unsubscribe wording

  • Key: optout_text · Default: empty, shown as "No longer want review requests? Unsubscribe."

Orders per sweep

  • Key: batch · Default: 50 · Range: 1–200
  • How many reminders one hourly sweep sends, at most, for each reminder in the sequence, newest due orders first. Orders already asked, or with nothing to ask about, are read past and not counted. The free edition uses at most 50.

Press Save changes to store the settings.

License & updates — Full edition

Enter your GM-XXXXX-… key and press Activate. The card shows the status, the renewal date and how many of your sites use the key; an expired licence keeps working and only stops updates. Deactivate on this site frees the key. A failed connection never changes your licence state.

For developers

The full edition's screen ends with For developers, listing every filter. See the developer reference.

Shopping Cart
Scroll to Top