Import Free & Paying Members

Article author
Duncan Hamra
  • Updated

This article will show you how to import a CSV of free members, paying members, or both into Memberstack 2.0.

If you are migrating from another authentication or payment provider, please read this entire article carefully before committing to Memberstack. There are situations where members cannot be imported. For example: if you have paying members, but cannot provide a Stripe Customer ID).

If you are migrating from Memberstack 1.0, the CSV you export from 1.0 will contain all of the required columns. Example 1.0 Export. 

Importing Free Members

Your CSV file can contain up to 10k rows, and contain the following columns: 

  1. Email Address (required)
  2. Password OR Hashed Password (optional)
    πŸ‘‰ If left blank, a password will be generated automatically.
    πŸ‘‰ If you're migrating from Memberstack 1.0, the "Hashed Password" column will be included automatically.
  3. Member ID (recommended)
  4. A column for each of your custom fields like name, phone, address, etc.
  5. Free Plan ID or comma-separated list of free plan IDs if you want more than one.
  6. Login Redirect (optional)
    πŸ‘‰ Formerly known as user-specific pages. 
  7. JSON (optional)
  8. Metadata (optional)

Importing Paid Members

  1. All of the above ☝️ plus...
  2. Stripe Customer ID (required)
  3. Stripe Subscription ID (required for recurring-subscripitions)
    πŸ‘‰ Rare: If the subscription contains multiple line items Memberstack will only respect the 1st line item.
  4. Free plan ID for free plans and one-time payments.
    πŸ‘‰ One-time payments should be imported as free plans. For example: If a member has a $499 one-time membership, they can’t be associated with an equivalent $499 one-time price. They will need to be placed on a new free plan instead. Be sure to still include the Stripe Customer ID to save their payment methods.

Free Trial Limitations

Please contact us if you are attempting to migrate 1.0 members with free trials. A seamless migration for trialing 1.0 members is not possible at this time. 

Was this article helpful?



Please sign in to leave a comment.