Migration Checklist | Any Paying Members

Article author
Duncan from Memberstack

Ready to migrate your site from Memberstack 1.0 to 2.0? This article will guide you through what's needed. If you do NOT have any paying members, please see this article instead. 

To be 100% upfront, this is not a "quick" process and there is a risk of things breaking along the way. You'll want to sit down with your team and a calendar to map out your migration from start to finish. 

Along those same lines, if your current site is working well and you don't need any of the functionality 2.0 provides you are welcome to stay on Memberstack 1.0 (if it ain't broke don't fix it, and all that).

We've designed this process to optimize for the following things... 

  • Super low impact for your members (they should never know).
  • Avoid churn (due to SCA, notifications, etc.).
  • A situation where someone cancels, creates an account, upgrades, etc. during a migration.

Note: All Membership IDs will be changed to Plan IDs and all third-party tools using membership ids would need to be updated to plan IDs. This includes all zaps. We also suggest disabling any triggers that fire when a subscription has been updated otherwise, your zap will fire for every imported member.

Before Migration

Create a new account with Memberstack 2.0. (1.0 and 2.0 accounts are 100% independent of each other.)

  1. Follow these instructions to manage 1.0 and 2.0 header scripts. This will let you set up 2.0 on your 1.0 site.
  2. Use our handy “plan import tool” to import your paid memberships from Stripe.
  3. Manually recreate your free memberships as free plans in 2.0.
  4. Once your plans are in, you’ll need to configure your redirects, gated content, and other plan settings.
  5. Next, you'll want to recreate your custom fields in 2.0. Custom fields have not changed. As long as your 2.0 IDs match your 1.0 IDs you won't need to update your site. 
  6. We recommend migrating your site 1:1 and then adding additional functionality like email verification, multiple memberships, social logins (coming soon), etc. .
  7. Add or update the following elements. Most attributes are the same, but some have changed. You can keep your old attributes in place without conflict since 1.0 is unaware of 2.0's attributes and vice versa.
    1. If you want to use our pre-build modals…
      • Login modal → data-ms-modal=”login”
      • Signup modal → data-ms-modal=”signup”
      • Forgot Password modal → data-ms-modal=”forgot-password”
      • Profile modal → data-ms-modal=”profile”
    2. If you want to build your own UI in Webflow then.
    3. Paid plans →  data-ms-price:update="PRICE ID"
    4. Free plans → data-ms-plan:add="PLAN ID"
    5. Attributes to show/hide content → data-ms-content="members"
    6. Logout links are now → data-ms-action="logout"
    7. Dynamically link to members-only content (new)
    8. Follow these steps to make site content more secure
  8. If you have any custom code, you’ll need to update a few things to get it working with 2.0. Convert 1.0 front-end API code to 2.0 DOM code.
  9. Upgrade your Memberstack account. If you already have a 1.0 plan then you can follow this guide to transfer over your subscription
  10. Set up your live mode and test mode domains. Your live mode domain should be the same domain members will use after migration. Probably your 1.0 domain.
  11. Schedule downtime on your website & turn your password protection page into a “scheduled maintenance” page. Here's a cloneable to start from. 
  12. (Optional) Contact Support to schedule a call with our team to help with the actual migration. 

During Migration

Only start this section after your site has been thoroughly tested.

  1. Join the call from the previous step. 
  2. Password-protect your signup, login, and profile pages. Its important members cannot create or access their accounts during this time.
  3. Export members from 1.0 and Import your free and paying members into 2.0.
  4. Comment out the big header script from part 1, step 1 and add your new Memberstack 2.0 header script. Publish your site (with password protection still enabled).
  5. Test, test, and test.
    1. If everything works as expected →  Remove password protection and proceed to the next section.
    2. If you need to roll back → Remove the 2.0 script and uncomment the big header script from step 1. 
    3. If you can’t resolve the issue, remove password protection (so members can use 1.0 again) & contact Memberstack support.

After Migration

  1. Cancel your subscription with Memberstack 1.0. You can ignore any mention of 10%. 

You’re done!

Was this article helpful?

Comments

8 comments

  • Comment author
    Al Mazlin

    Will the updated attributes work on my site while it is still running MS 1.0?

    (Say I need to publish halfway through — will people still be able to log in/out and access their membership modals?)

    0
  • Comment author
    Alastair Budge

    One thing that seems to be missed in this checklist: You will need to update links to show/hide content on a page.

    For example, `ms-hide-element` doesn't work in 2.0. It needs to be changed as per this page.

    0
  • Comment author
    Duncan from Memberstack

    Al Mazlin 

    Will the updated attributes work on my site while it is still running MS 1.0?

    Yes and no... If there's a new attribute for 2.0 then you'll need to add the new attributes AND keep the old attribute. 1.0 will use the old and ignore the new. 2.0 will use the new and ignore the old. Does that make sense?

    0
  • Comment author
    Duncan from Memberstack

    Alastair Budge you are correct! Thank you 🙏 I've updated the article

    0
  • Comment author
    Aslam Ghouse

    Are there any additional considerations if we're using WordPress instead of Webflow?

    1
  • Comment author
    Duncan from Memberstack

    Hi Aslam Ghouse, we (the internal Memberstack team) have not migrated a site to WP before. And I'm not aware of any customers that have done so either. 

    To confirm, are you migrating from WP and/or to WP.

    0
  • Comment author
    Aslam Ghouse

    Hey Duncan from Memberstack

    We're already with wordpress (tickernerd.com) we just want to migrate to Memberstack 2.0 so we can offer our customers additional features like Google sign in and apple/google pay.

    0
  • Comment author
    Duncan from Memberstack

    Understood 🤔 I can't recommend Memberstack to you at this time since we don't do any testing with Wordpress. I can't guarantee you won't run into issues. That said, I know Remodelista is using Memberstack + WP. So they found a way 🤔

    0

Please sign in to leave a comment.