Email templates
Last updated November 20, 2026
Every email Gorilla Returns sends — to customers and to admins — uses an editable template. You can rewrite them in your own voice, add your branding, change the subject lines, and insert placeholder tokens that get replaced with real data when the email is sent.
No HTML email designer, no drag-and-drop builder — just plain text with tokens. This is on purpose: plain-text emails deliver well, render consistently everywhere (Gmail, Outlook, Apple Mail, phones), don’t look like marketing, and read as personal correspondence from a real business. Which is what you want when someone’s returning something.
Where to edit templates
Go to Returns → Settings → Email templates. You’ll see every template Pro sends:
- Submitted — confirmation email the customer receives after submitting a return request
- Approved — the email the customer receives when you approve their return (includes label if applicable)
- Rejected — the email when you reject a request
- Completed — notification when the return is marked complete
- Admin notification — new request — the email you (and any configured admins) receive when a customer submits a new request
Click any template to open the editor. Each has a Subject field and a Body field. Both accept placeholder tokens.
Placeholder tokens
Tokens are wrapped in curly braces and get replaced with real values when the email is sent. The full list:
Customer tokens
- {customer_name} — the customer’s full name
- {customer_first_name} — first name only
- {customer_email} — their email address
Order tokens
- {order_number} — the WooCommerce order number
- {order_date} — the date the order was placed
- {order_total} — original order total
RMA tokens
- {rma_token} — the public RMA identifier (like GR-A1B2C3D4)
- {rma_items} — the list of items being returned, formatted as a readable block
- {rma_reason} — the reason(s) the customer gave
- {resolution} — “Refund,” “Exchange,” or “Store credit”
- {refund_amount} — gross refund amount (before shipping fees)
- {shipping_fee} — return shipping fee being deducted
- {net_refund} — refund minus shipping fee
- {store_credit_code} — the credit code (only valid in the Approved template for store-credit RMAs)
- {store_credit_amount} — the credit amount including any bonus
- {approval_note} — your custom per-approval note from the approve form (only valid in the Approved template)
Store tokens
- {store_name} — your WooCommerce store name
- {store_url} — your site’s home URL
- {portal_url} — the URL to your return portal (defaults to /returns/)
The “Note to customer” per-approval field
On the RMA detail view’s Approve form, there’s a Note to customer textarea. Anything you type here gets inserted into the Approved email at the {approval_note} token location.
Great for case-specific context:
- “Please include the original packaging — the box helps us refurbish and resell to another customer.”
- “Really sorry about the defect. The replacement is going out today.”
- “Please ship by Dec 20 to hit the end-of-year refund window.”
If you don’t add a note, the {approval_note} line is removed entirely from the email — no awkward blank space where “A note from us:” would have been.
Example template — Approved
Here’s the default template body, which you can modify however you want:
Hi {customer_first_name},
Great news — your return request {rma_token} is approved.
What you’re returning:
{rma_items}
Resolution: {resolution}
{net_refund}
{approval_note}
Your prepaid USPS return label is attached to this email.
Drop the package at any USPS location or hand it to your
mail carrier. There’s no additional postage to pay.
If you have questions, just reply to this email.
Thanks,
{store_name}
{store_url}
The subject line template is just: Return request {rma_token} — approved
Resetting to defaults
If you edit a template and later want to go back to the shipped default, click Reset to default at the bottom of the editor. Your changes are discarded and the original template reloads.
Testing templates
At the bottom of each template editor is a Send test to… field. Type an email address, click Send test, and Pro renders the template with fake sample data and emails it to you. This is the fastest way to see how your tokens expand before a real customer sees them.