Skip to main content

8.3 Built-in Form Fields

Built-in Form Fields

Every field available in the Profile Edit Form's field picker. "Saves to" shows where the value lands: the WordPress user record (the standard profile fields visible in the admin user editor) or user meta.

FieldInput typeSaves toNotes
First nameTextUser record
Last nameTextUser record
NicknameTextUser recordAlways required (WordPress requirement).
Display NameSelectUser recordOptions are WordPress's standard display-name variants built from the user's names.
EmailEmailUser recordAlways required (WordPress requirement).
Current passwordPasswordVerification only, nothing is saved. When present, the form refuses to save unless it matches the user's current password.
Change PasswordPasswordUser recordBlank leaves the password unchanged. Optional strength indicator with minimum level, and optional confirmation field.
WebsiteTextUser record
TwitterTextUser meta
FacebookTextUser meta
BiographyTextareaUser recordThe standard "Biographical Info" profile field.
Custom fieldConfigurableUser metaSaves under the meta key you set. Type is Text by default; more types via the bpb_custom_field_types filter. See the Developer Reference.
TitleA layout element: renders a heading and can wrap the following fields in a fieldset until the next title or the end of the form.

Custom field types

When enabled by a developer, the Custom field supports these additional input types, each with its own options in the field settings:

TypeExtra options
Date PickerDate format, optional calendar icon with position and color.
Time PickerTime format, minute step, optional clock icon with position and color.
SelectOptions list (value|||Label per row), optional multiselect.
RadioOptions list, inline display, label placement, column count.
Multi CheckboxOptions list, optional Select All control, inline display, column count.
CheckboxSingle checkbox with label placement options.
Other HTML input typesEmail, URL, Tel, Number, Date, Month, Time, Week, and Datetime inputs rendered with the browser's native controls.