The import process involves two important steps: prepare your import file (CSV) and process the import. Refer to this section of the docs for help adding the correct CSV headers and data for your import.
1. Prepare Your Import File
Download the template here (import.csv.zip) to use as a basis for your data for import file. This template does not include every field you may need to import and may also include fields you do not need to import.
You can also access a starter import template file within your own site. Navigate to Users > Import Members in your WordPress admin. You’ll see a link to download the example CSV file from this page.
There’s a full list of required and optional import fields in the documentation sections below.
Your file must have a header row and a user_email column. Every other column is optional, including the membership columns. Leave out membership_id to create or update users without changing their membership.
You can import a file exported from PMPro without editing it first. When PMPro exports a text value that starts with =, +, -, or @, it adds a leading apostrophe so spreadsheet programs don’t treat the value as a formula. The import removes that apostrophe, so the value is saved as it was before the export.
2. Process the CSV Import
Once you’ve got your template set up, you can proceed with importing members.
Only administrators can see the Import Members screen and run an import (users with the manage_options capability, or manage_network_users on multisite). An import can set the role, password, and profile data of any user, so we don’t recommend opening it to other roles. Developers can change the capability with the pmproiucsv_import_capability filter. See Action and Filter Hooks.
- Navigate to Users > Import Members in the WordPress admin to confirm your import settings.
- Import File (.csv): Choose the CSV file to import.
- Notify Members: Check this box to send new users an email with their username and a link to reset their password.
- Update Existing Users: Check this box to update existing users when a matching username or email address is found (recommended). If it’s unchecked, rows for an existing username or email address are skipped and listed in the error log. Rows with an
IDcolumn that matches an existing user always update that user. - Skip Existing Members: If you suspect your CSV has duplicate records for existing members, check this box. This selection will skip changing the membership level of users with the same active membership level during import. It only applies to rows that include a
membership_id. - Click the Import button.

3. Map Your CSV Columns
After you click Import, the Map CSV Fields screen lists each column in your file with a sample value from the first row. Use the Maps To dropdown to choose where each column’s data is saved.
- Automatic matches: We pre-select a field when the column heading matches a field key, such as
user_emailormembership_id, or a common name like “First Name”, “Email”, or “Expiration Date”. Matching ignores uppercase and lowercase letters. - User Fields: PMPro User Fields are listed in the dropdown, grouped by their field group as “[Group Name] (User Fields)”. A column whose heading matches a User Field’s name is mapped to that field automatically.
- Custom User Meta: Choose this option to save a column as user meta. The screen shows the meta key it will use, which is the column heading in lowercase with spaces and special characters removed.
- Skip Column: Columns that don’t match a known field start as “Skip Column” and are not imported. Review these before you continue.
A column must be mapped to Email Address. If it isn’t, the import stops before any data is saved. Fields from other Add Ons, such as the Lock Membership Level Add On, can also appear in the dropdown in their own group.
- Check the Maps To field for each column. Columns set to “Skip” will not be imported.
- Click “Confirm Mapping and Import“. To start over, click Cancel, which deletes the uploaded file without importing anything.

4. Finish the Import
The Processing Import screen imports your file in batches of 50 rows and shows its progress in the status box. Keep this page open until you see “Done!”.
- To pause, click Click here to pause the import. Click the link that replaces it to resume.
- If the import stops or you close your browser, open the resume URL shown at the top of the screen to continue where it left off.
- When the import finishes, you’ll see a success message. If some rows couldn’t be imported, the message links to the error log, which lists the CSV line number and reason for each one.

Safety Tips for Importing
We recommend testing the import with a portion of your data or with testing data until you can confirm your CSV is properly formatted.
Once you can trust your spreadsheet format and confirm that the correct and complete data is imported, try a smaller segment of your actual data.
Get Support From Our Team of Experts
Have a question about how to use this feature? Our Support Page outlines three ways to get support.
Our Max plans include hands-on help customizing your membership site and implementing new features. Upgrade to PMPro Max now »
Last updated on November 19, 2026