Registration Form Fields Reference (SA #1786)

Registration Form Fields Reference

This article includes all you need to know about the proper field names when building an online form.

How field names work

A registration form creates a new member profile from the fields it posts, and signs that member in. Every field name below can be written four ways, and the form processor treats them as the same field:

Name form	Example	Effect
`name`	`fname`	Optional field
`R_name`	`R_fname`	Required field; the form is rejected if it's blank
`name_P`	`fname_P`	Optional, and its value is passed to the next page in the query string
`R_name_P`	`R_fname_P`	Required, and passed to the next page

The R_ prefix must be an uppercase R. When a required field is blank, its name is shown to the visitor in the error list with the prefix and underscores removed.

Validation rules

These checks run before any profile is created. If one fails, the visitor is returned to the form with an error message.

Field	Rule	Error shown
`email`	Always required for registration, even without the `R_` prefix. Must contain `@` and `.`	Please provide a valid E-MAIL ADDRESS
`fname` / `lname`	First and last name can't be identical	FIRST NAME and LAST NAME cannot match
`password2`	If included, must match `password`	Password must match
`username`	If included, must not already belong to another member of the site	This USERNAME is already in our database

A visitor who is already signed in can't register again; they see "You are already REGISTERED and SIGNED IN."

Profile fields

Each field below saves to the matching item on the member's profile. Any field left out of the form is simply saved blank.

Field name	Saves to	Notes
`salutation`	Salutation
`fname`	First name
`middle`	Middle initial
`lname`	Last name
`suffix`	Suffix
`name`	Full name
`email`	Email	Required
`username`	Username	Defaults to the email address
`password`	Password	Defaults to a system-generated number
`password2`	(not saved)	Confirmation only
`company`	Company
`title`	Job title
`occupation`	Occupation
`gender`	Gender
`birthdate`	Birth date
`spousename`	Spouse name
`address`	Home address
`address2`	Home address line 2
`city`	Home city
`state`	Home state
`zip`	Home ZIP
`county`	Home county
`country`	Home country
`phone`	Home phone
`homephone`	Home phone	Used instead of `phone` if both are sent
`phone2`	Work phone
`mobilephone`	Mobile phone
`fax`	Fax
`website`	Website URL
`website_name`	Website name
`website_description`	Website description
`bio_short`	Short bio
`bio`	Full bio
`emailformat`	Email format preference
`optinvoice`	Voice opt-in
`optinsms`	SMS opt-in
`fedid`	Federal ID
`userfield1` to `userfield5`	Custom fields 1 to 5	Five general-purpose fields
`source`	Lead source
`publish`	Publish setting

Optional add-ons

A registration form can also place the new member into categories, memberships, or a program in the same submission. These run after the profile is created.

Field name	What it does
`categoryid`	Adds the member to one category, by category ID
`categoryid{N}`	Adds the member to category N when checked, e.g. `categoryid42`. Use one checkbox per category
`categoryid{N}_text`	Saves a text answer alongside category N
`membershipid`	Subscribes the member to one membership, by membership ID
`membershipid{N}`	Subscribes the member to membership N when checked, e.g. `membershipid7`
`deliveron_mon` to `deliveron_sun`	Sets which weekdays membership content is delivered (seven fields: `_mon`, `_tue`, `_wed`, `_thu`, `_fri`, `_sat`, `_sun`)
`enrollment`	Any value turns on program enrollment
`programid`	The program to enroll in. Required when `enrollment` is used

The category, membership, or program must already exist for the site, or the form shows an error. A member is never added to the same category, membership, or program twice. If a program requires approval, the enrollment is saved as pending.

Version 1.1 • Last Updated 10/16/2026 10:42:00 AM

Back to Search