Upgrading from the old Pro version (3.x)

What changes

Previously all Pro features lived in one plugin („Double Opt-In … - Pro", version 3.x). The new version is modular: a lean base plugin „Double Opt-In" (version 5.x) plus the „Double Opt-In Pro" bundle (version 4.x) that manages your license and unlocks the individual feature modules (add-ons). The feature set stays the same — it's just split more cleanly so you only load what you actually use.

Your data is safe

Nothing is lost during the switch:

• All opt-in records and consent proofs are kept (identical database tables).
• Your global settings and your per-form configuration continue to be used unchanged.
• Your license key is migrated automatically when you activate the Pro bundle — you don't need to re-enter it.

No reconfiguration required.

Before you start

• Take a backup of your database and files (standard before any plugin change).
• Keep your license key handy (in your forge12.com account or on your invoice) — as a fallback in case the automatic migration doesn't kick in.

Important: don't run both versions at once

The old Pro version (3.x) and the new version must not be active at the same time — otherwise you may get duplicate confirmation emails and double processing. So deactivate the old version first.

Step by step

1. Deactivate the old Pro version: Under Plugins, deactivate the old „Double Opt-In … - Pro" (version 3.x).
2. Install the base plugin: Install and activate „Double Opt-In" (version 5.x).
3. Install the Pro bundle: Install and activate „Double Opt-In Pro" (version 4.x). On activation your license key is migrated automatically — a notice about this shows in the admin area for about a week. If for some reason no key is present, enter it under Double-Opt-in → License.
4. Activate the feature modules: Activate the modules for the Pro features you use (e.g. Reminder, Analytics, MX validation). Download them from your forge12.com account and activate them like any plugin. Developer tip: with define('F12_DOI_AUTO_INSTALL_ADDONS', true); in wp-config.php the bundle installs the modules covered by your license automatically.
5. Delete the old version: Afterwards delete the old Pro plugin (3.x) (remove the plugin folder) so it can't be reactivated by accident.

Which feature lives in which module now?

• Unsubscribe / opt-out → „Opt-Out" module
• Reminder emails → „Reminder" module
• MX validation → „MX-Validator" module
• Block disposable addresses → „Domain-Blocklist" module
• Prevent duplicate sign-ups → „Unique-Email" module
• Export (CSV/JSON) → „Consent-Export" module
• Analytics dashboard → „Analytics" module
• Conditional content/templates → „Conditional" module
• Automatic user creation → „User-Registration" module
• Avada / Elementor / WPForms / Gravity Forms → a dedicated builder module each

Verify afterwards

• Under Double-Opt-in → License the modules should show as licensed.
• In Double-Opt-in → Database: your existing opt-ins are still there.
• Submit a test form and run through the confirmation flow once.

If something's off

• License not migrated? Enter the key manually under Double-Opt-in → License.
• A feature is missing? Check that its module is installed and activated.
• A column/table missing after the update? Deactivate and reactivate the base plugin once — that updates the database tables.