1. Memberstack 2.0
  2. Guides & Tutorials
  3. Migration Docs

Using the Memberstack Legacy Adapter

Article author
Memberstack Team
  • Updated

1. Import your plans into Memberstack 2.0

Use the Plan Import Tool to bring your Stripe memberships into your new 2.0 app. Keep the list of v1 membership ID → v2 plan/price ID pairs handy — you'll need them in the next step.

2. Generate your adapter script with Rey

Go to rey.memberstack.com (our Memberstack-aware AI assistant) and give it:

  • Your v1 App ID
  • Your v2 App ID and Public Key
  • Your v1 → v2 membership/plan ID pairs from step 1

Ask Rey to generate your Legacy Adapter install script. It'll hand you back something like:

<script>
  window.memberstackConfig = {
    adapter: {
      enabled: true,
      importedMemberships: {
        "V1_MEMBERSHIP_ID": "pln_V2_PLAN_ID",
        "V1_PAID_MEMBERSHIP_ID": "prc_V2_PRICE_ID"
      }
    },
    appIdV1: "YOUR_V1_APP_ID",
    appId: "YOUR_V2_APP_ID",
    publicKey: "YOUR_V2_PUBLIC_KEY",
    debug: true
  };
</script>
<script src="https://cdn.jsdelivr.net/gh/raqlo/memberstack-legacy-adaper@v0.6.1/dist/memberstack-adapter.js"></script>

3. Add the script to your site <head>

Paste it above your existing Memberstack 1.0 script and publish.

Nothing changes for your visitors yet — everyone still sees Memberstack 1.0. The adapter is installed but dormant.

4. Test on 2.0 yourself

Visit any page on your site with ?adapter=v2 added to the URL, e.g.:

https://yoursite.com/account?adapter=v2

Your browser is now running on Memberstack 2.0 for the rest of the session. Log in, check gated content, test forms, etc. Everyone else on the site is still on 1.0.

If something doesn't work, paste the error (or what you're seeing) back into Rey — it can help debug and adjust your config.

5. Flip the whole site to 2.0

When you're confident everything works, ask Rey to update your config to force v2 for all visitors. The change is a single line:

adapter: {
  enabled: true,
  forcedVersion: "v2",
  importedMemberships: { ... }}
 

Republish. All visitors are now on 2.0.

6. Rolling back

If something breaks, remove forcedVersion: "v2" (or set it to "v1") and republish. You're back on 1.0 instantly — no script swap needed.

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.