Reserved fields that can't become custom fields

Several fields are built into the beehiiv platform to support core functionality like subscriptions, referrals, analytics, and publication metadata. While these reserved fields can’t be used as custom fields in your account, they can be used as merge tags to personalize posts, automations, and welcome emails.

Use the lists below to identify which fields are reserved so you can rename or adjust your data before importing subscriber lists. Click each section to view details.

Reserved fields related to subscriptions

active_subscriber_count

api_subscription_id

email

email_address_id

hostname

integration_connect_url

jwt_token

list_unsubscribe_token

live_url

opt_in_token

report_abuse_token

resource_id

reward_promo_code

subscriber_email_hash (uses MD5 encryption)

subscriber_email_hash_sha1

subscriber_email_hash_sha256

subscriber_id

subscriber_preferences_url

subscriber_refer_url

subscriber_referral_hub_url

subscription_id

subscription_uuid

unsubscribe_url

Reserved fields related to the publications and posts

address_text

copyright_text

partner_url

publication_alphanumeric_id

publication_name

publication_name_param

rss_first_item_description

rss_first_item_title

Reserved fields related to referrals

rp_display_with_milestone_styles

rp_display_with_no_milestone_styles

rp_next_milestone_name

rp_num_referrals

rp_num_referrals_until_next_milestone

rp_next_milestone_image_styles

rp_next_milestone_image_url

rp_personalized_text

rp_referral_hub_url

rp_referral_code

rp_refer_url

rp_refer_url_no_params

rp_refer_url_with_params

rp_upcoming_milestones

Reserved 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

Reserved fields used for suffixes or related to dates, times, or numbers

_currency_x

_currency_x_no_cents

_dmy

_mdy

_ymd

_dmy_dashed

_mdy_dashed

_ymd_dashed

_dmy_dotted

_mdy_dotted

_ymd_dotted

_full

_round0

_round1

_round2

_round3

current_date_dmy

current_date_mdy

current_date_ymd

current_date_dmy_dashed

current_date_mdy_dashed

current_date_ymd_dashed

current_date_dmy_dotted

current_date_mdy_dotted

current_date_ymd_dotted

current_date_full

current_date_full_md