Get Help Your Way

OR

Updated: Nov 7, 2024

How to import free subscribers and map custom fields or tags

In this article, we cover the steps for importing free subscribers and mapping custom fields for them. For information on importing previous newsletter content to beehiiv, please refer to this article

Important Note: In order to complete the following steps, you will need to have a CSV file of the subscribers that you wish to import. If you were on a previous platform, you can export the list directly from them.

For easier mapping during the import, it's best practice to review your CSV file and make sure the header fields use the same names as the subscriber tags and custom fields that you’ll be using in beehiiv, and remove any data that you don’t plan to use.

How to import free subscribers 

  1. From the left panel Dashboard, scroll down and click Settings.



  2. Your publication settings will open. If you have multiple publications, select one from the dropdown options. Click Subscribers Import from the left panel.



  3. Depending on the amount of subscribers you need to import, choose accordingly.

    Tech Note: Anyone importing more than 10 subscribers into beehiiv will need to verify their identity through Stripe Identity Verification.

    To import 1 to 10 subscribers: Click New Subscribers Import.



    To import 11 to 10,000 subscribers: After completing Stripe Identity Verification, click New Subscribers Import.



    To import over 10,000 subscribers: After completing Stripe Identity Verification, scroll down to the Request to raise your import limit section and click Open Request Form. A form will appear on the right for you to make the request directly from your account.



  4. After clicking New Subscribers Import, you’ll be prompted to select an import method. By default, Upload a CSV file will be preselected, but you can also choose to Copy and paste a list of email addresses.

    Click Choose File and select the CSV file from your device. Once added, click Next to proceed.



  5. You'll be presented with a few Advanced Configurations (optional). You can choose to Send Welcome Email, Add to Automation(s), or Apply Subscriber Tags. Simply toggle each option on to activate it.

    A summary of your selections will appear on the right. Click Confirm Subscribers Import to proceed.



  6. A confirmation message will appear, prompting you to verify that all contacts on the list have knowingly opted in to receive emails from you. Click Import to confirm.


How to map custom fields and subscriber tags during a subscriber import 

After the subscriber import process has begun, you’ll be prompted to start mapping out the fields from the CSV file as either custom fields or subscriber tags within beehiiv.

What’s the difference between custom fields and subscriber tags?

  • Custom fields are data fields that your subscribers share with you, like name, age, address, and any additional information that is unique to each subscriber. 
  • Subscriber tags are internal labels used to identify and group subscribers in your account. A good example of this is tagging subscribers as “friends and family” or “affiliates” to identify that group.

To map a column to either a subscriber tag or a custom field, simply select which of those you’d like to map it to from the dropdown options by clicking on the down arrow to access them.


Some things to consider when mapping custom fields

  • Email is the only required custom field, so if no columns are selected, emails will still be imported from the CSV.
  • If you have additional fields in your CSV beyond the standard email address, you can choose which of these fields to import.
  • If a contact in the CSV already exists within your subscriber list, you’ll have the option to overwrite existing custom field data when you import. If you don’t want to do this, simply uncheck that box.

If you have an existing custom field corresponding to any of the data fields that you’re importing, you can select it from the dropdown. Otherwise, you can create a new one by selecting New Custom Field.

When adding a new custom field, you’ll need to give it a Name and select a Data Type. Choose from Text, Number, True/False, Date, or Date & Time.

Repeat this process until you have chosen an option for each custom field you are importing. 


Some things to consider when mapping subscriber tags

  • If a contact in the CSV already exists within your subscriber list with tag(s) applied to them, you won’t be able to override the existing tag data with the import.
  • If you have multiple tags for a subscriber, be sure that your tags are formatted correctly within the specified tag column and there are no unescaped commas.

When done making your mapping selections, be sure to review them all for accuracy, then click on the Import button.

Once completed, you can scroll down to the Historical Imports section and you will see how many subscribers were accepted.


You can then view the new subscribers by navigating to the Audience > Subscribers section of your account. To see any newly imported custom fields, click on an individual subscriber’s name and navigate to the Custom Fields tab.

Related Articles

© 2024 beehiiv, Inc. All rights reserved.

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple

Newsletters made simple