List of reserved fields that can't become custom fields

When uploading and importing a subscriber list into beehiiv, certain fields cannot be imported as custom fields. These reserved fields are not eligible for customization because they are used elsewhere in beehiiv, for example many are reserved for merge tags.

Below are lists of reserved fields to help you identify which ones need to be renamed or adjusted before importing. Click on each to reveal the details.

Reserved custom fields related to subscriptions

active_subscriber_count

email

hostname

jwt_token

list_unsubscribe_token

live_url

opt_in_token

publication_alphanumeric_id

publication_name

publication_name_param

report_abuse_token

resource_id

reward_promo_code

subscriber_email_hash

subscriber_id

subscriber_preferences_url

subscriber_refer_url

subscriber_referral_hub_url

subscription_id

subscription_uuid

api_subscription_id

Reserved custom fields related to the Referral Program

rp_num_referrals

rp_num_referrals_until_next_milestone

rp_display_with_milestone_styles

rp_display_with_no_milestone_styles

rp_next_milestone_name

rp_personalized_text

rp_next_milestone_image_styles

rp_next_milestone_image_url

rp_referral_hub_url

rp_referral_code

rp_refer_url

rp_refer_url_no_params

rp_upcoming_milestones

Reserved custom fields related to analytic tracking

app_version

browser

city

country

device_type

landing_page

latitude

longitude

open_tracking_pixel

os

os_version

platform

referrer

referring_domain

region

user_agent

utm_campaign

utm_content

utm_medium

utm_source

utm_term