Bulk Import Subscribers

With the bulk import subscribers extension you can import a large list of users at once with a CSV file. When you install the extension, a new section will appear on the subscriber page that will let you upload a CSV file.

Note: You must be running at least Leaky Paywall 3.8.0 to use this add-on.

Don’t have the Bulk Import Subscribers add-on? Get it here.


There is a link under the input to an example csv file. We recommend downloading the file and using it as a template for your CSV import file.

Download example CSV file

The only required fields are email and level_id, but there are many more fields you can import for a subscriber.

Subscriber Fields

The unique email address of the user. A new subscriber email will be sent to the user’s email address during import if they are not already a user on your site.

The unique username of the user. If no username is specified, one will be generated from the user’s email address during import.

The level ID that the user will be subscribed to. You can find the level IDs by going to Leaky Paywall > Settings and scrolling down to the Subscription Levels section. Under the subscription name you will see the Subscription ID number. This is the level ID.


The subscriber ID is custom ID that you can assign to a user. It is not required, but can be helpful if you need to track the user by the ID of another system’s database you are using, like a CRM.

The price you charged the user. This is useful if you charged the user offline for the subscription. Note: Even if you add this field, Leaky Paywall will not actually charge the user. If no value is set, the default will be 0.00.

The plan the user is subscribed to. For manually created subscribers, this is usually Recurring or Non-Recurring. If no value is set, the default will be Non-Recurring.

The date the subscription expires. Please use the following format for your date: June 5, 2020. You can also specify “Never” for an infinite subscription length. If no value is set, the default will be Never.

The current status of the subscriber. This can be set to: active, deactivated, or canceled. If no value is set, the new subscriber status will be set to active.

My import isn’t working

It could be the line feed code of the CSV file. Make sure the CSV file is exported in UTF-8 format.