Getting started
Last updated November 20, 2026
Gorilla Returns Pro takes about ten minutes from install to a working customer portal on your site. This article walks through every step of the setup wizard — exactly what it asks for, why, and what happens after.
Before you start
You’ll need:
- A WordPress site running WordPress 6.0+ and PHP 8.0+
- WooCommerce 7.0+ active on the same site
- Your Gorilla Returns Pro license key from your purchase confirmation email (or your SureCart customer dashboard)
- An EasyPost account if you plan to generate prepaid USPS labels (free to sign up, you pay USPS commercial rates with no markup). Skip this if you’ll process returns manually without labels.
Install the plugin
- In your WordPress admin, go to Plugins → Add New Plugin → Upload Plugin.
- Click Choose File and select the gorilla-returns.zip file from your purchase confirmation email.
- Click Install Now, then Activate Plugin.
Upgrading from the free version? If you already have the free version of Gorilla Returns from WordPress.org installed, Pro automatically detects it, migrates your existing return requests, and deactivates the free version. There’s a dedicated article on this at Upgrading from the free version.
The setup wizard
Right after activation, Pro loads a full-screen six-step wizard. You can skip through to the end and come back later, or go step by step. It’s resumable — closing the browser tab doesn’t lose your place. You can rerun it any time from Returns → Setup wizard.
Step 1 — Welcome
Overview of what the wizard will ask you. Click Get started.
Step 2 — License
Paste your license key and click Activate. Pro verifies the license with our SureCart licensing service and unlocks every Pro feature. If this step shows an error, see Troubleshooting.
Step 3 — EasyPost
If you plan to use prepaid labels, paste your EasyPost API key here and fill in your warehouse return address. The address is what USPS prints as the destination on every return label — the labels only work if this matches a real location you’ll receive mail at. Full detail: Prepaid USPS labels.
You can skip this step entirely and process returns without labels — customers will handle shipping themselves and send tracking.
Step 4 — Return policy
Configure the three defaults every store needs:
- Return window — how many days after order completion a customer can request a return. Default: 30.
- Return reasons — the list customers pick from when filing a request. Default list covers “Doesn’t fit,” “Defective,” “Wrong item,” “Didn’t match description,” “Other.” Edit to fit your store.
- Eligible order statuses — which WooCommerce order statuses can file returns. Default: completed, processing, shipped, delivered. More detail in Eligible order statuses.
Step 5 — Portal page
Pro auto-creates a WordPress Page called Returns at /returns/ with the [gorilla_returns_portal] shortcode on it. This is where customers go to file requests. The wizard confirms the page exists and gives you a link to preview it.
If you want the portal somewhere else (a different URL, inside an existing Help Center page, etc.), you can move the shortcode to any page you like — see The customer portal.
Step 6 — Summary
Recap of everything the wizard set. Click Finish to land on the RMA inbox.
Your first test return
Before you tell your customers about the portal, do a test run:
- Place a small real order on your store (you can refund it afterwards).
- Mark the order Completed in WooCommerce.
- Open an incognito window and go to yourstore.com/returns/.
- Enter the order number and the email you used, click Continue.
- Select the item, pick a reason, pick a resolution (refund, exchange, or store credit), submit.
- Back in your admin, go to Returns → Return requests — the new RMA should be at the top, status Submitted.
- Open it, review, and click Approve.
That’s the full flow. If you connected EasyPost, approving generates a USPS label and emails it to the customer. If you didn’t, the customer gets an approval email asking them to ship using their own method.
What’s next
With the baseline working, these articles cover the specific features in detail:
- The customer portal — what your shoppers see, step by step
- The RMA inbox — the admin side
- Prepaid USPS labels — EasyPost integration and scan-based billing
- Variant exchanges — automatic replacement orders
- Store credit — the bonus multiplier for turning refunds into repeat revenue