Upgrading from the free version
Last updated November 20, 2026
If you’ve been running the free version of Gorilla Returns from WordPress.org and want to upgrade to Pro, the migration is a single click. Install Pro over the top of the free version and everything moves automatically. This article explains exactly what happens so you know what to expect.
What the free version includes
The free version on WordPress.org gives you:
- The self-serve customer return portal
- The full RMA inbox and workflow
- Submit / approve / reject / complete status transitions
- Return window + eligible-status gating
- Manual refund processing (you process the refund in WooCommerce yourself)
- WordPress.org community support
What Pro adds on top
- Prepaid USPS labels via EasyPost with scan-based billing
- Automatic variant exchanges with on-hold replacement orders
- Store credit with bonus multiplier
- Editable email templates with placeholder tokens
- Customer photo uploads for defect claims
- Per-RMA shipping fees
- Serial-returner protection
- Analytics dashboard
- Priority email support with same-day replies
The migration — step by step
- Purchase a Pro license and download the Pro zip file from your purchase confirmation email.
- In your WordPress admin, go to Plugins → Add New Plugin → Upload Plugin.
- Upload gorilla-returns.zip and click Install Now, then Activate Plugin.
- Pro detects the free version is active, runs the migration, and displays a green banner at the top of the admin: “Welcome to Gorilla Returns Pro! We migrated N return requests, your settings, and the shortcode on X pages from the free version — your customers can keep using the same portal URL.”
- The setup wizard opens so you can activate your Pro license, connect EasyPost, and configure the Pro-only features.
You don’t need to deactivate the free version first — Pro does it for you, silently, during the activation hook. There’s no moment when both are active and conflicting.
What gets migrated
Return requests (RMA data)
Every return request that exists in the free version’s database is copied into Pro’s database. The columns Pro has that Lite doesn’t (resolution, labels, store credit codes, admin email history) are left empty for migrated rows — they’ll fill in when those RMAs get further actions. Status, items, dates, notes, and tokens all preserve exactly as they were.
Settings
Lite’s settings (return window, eligible statuses, reasons list) are merged into Pro’s settings. If Pro already had a value for a setting — because you’d previously installed Pro and configured it — Pro’s value is kept, so you don’t lose your Pro config. If only Lite had a value, Lite’s value is used.
Portal page shortcode
The free version uses the shortcode [gorilla_returns]. Pro uses [gorilla_returns_portal]. Any published Page or Post containing the Lite shortcode is automatically rewritten to use the Pro shortcode. Customers’ bookmarks keep working — they land on the same URL, same page, same portal.
The free plugin itself
The free version is deactivated silently (no email, no notice to WordPress.org). Its files remain on disk under wp-content/plugins/gorilla-returns/. You can delete them manually if you want a clean plugins folder, but leaving them doesn’t hurt — they’re not loaded.
What does NOT get migrated
- The Lite database tables — Pro doesn’t drop the wp_grlite_rmas table. If something goes wrong with the migration and you need to roll back, your original Lite data is still there, intact.
- Nothing about your WooCommerce orders — Pro doesn’t touch WooCommerce. Your orders, customers, and products are exactly where they were.
How to roll back (if needed)
If you decide Pro isn’t working for you and want to return to the free version during the 14-day refund window:
- Deactivate Gorilla Returns Pro in Plugins.
- Reactivate the free version of Gorilla Returns.
- In any WordPress Page containing the Pro portal shortcode, change [gorilla_returns_portal] back to [gorilla_returns].
- Request a refund via the Refund Policy process. Your Pro license is deactivated; the free version continues working with your original Lite data.
You can also delete Pro entirely and keep the free version. RMAs created in Pro (including the migrated ones) will remain in Pro’s tables; the free version only reads from Lite’s tables, so any new activity happens there and the Pro data sits unused until you decide what to do with it. Email support if you want help reconciling.
FAQ
Can I install Pro without having Lite first?
Yes. The free version isn’t a prerequisite. Pro is a complete plugin on its own.
Will the migration ever re-run?
No. Pro stores an internal flag (gr_lite_migration_completed) after the first run. Subsequent activations are no-ops.
What if I had both Lite and Pro installed at once before this migrator existed?
Lite’s main plugin file checks for Pro’s constants on plugins_loaded and silently deactivates itself if Pro is active, going back to v1.0.1 of Lite. So they haven’t conflicted. The migration still runs cleanly for you — if Pro was already configured, Pro’s settings win, and Lite’s RMAs are copied.
Can I use Pro on multiple sites with one license?
Yes — a Pro license allows unlimited site activations. No per-site charge, no “enterprise tier.”