Register Form

A user registration form with Canvas styling. Requires user registration to be enabled in WordPress settings. It is shown in the block inserter as Register Form and registered as canvas-core/register-form.

Select the block on a page and its own settings open in the sidebar, in the panels below:

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Content

• Form HeadingDefaultRegister

  Title shown above the form. Leave empty for a form with no title.

• Submit Button TextDefaultRegister

  Wording on the button that creates the account.

• Redirect URL After RegistrationDefaultEmpty

  Where to send the user after successful registration. Defaults to the login page.

Fields

• Show First Name FieldDefaultOn

  Ask for a first name and save it on the new account.

• Show Last Name FieldDefaultOn

  Ask for a last name and save it on the new account.

• Require Terms AcceptanceDefaultOff

  Add a tick box the visitor must accept before the account is created.

• Terms Acceptance TextDefaultEmpty

  Shown next to the terms checkbox. HTML links are allowed.

  Shown when Require Terms Acceptance is on

• Show Username FieldDefaultOn

  Ask the visitor to choose a username. With this off the form is shorter and the login name is derived from the email address instead.

• Show Password FieldDefaultOn

  With this off the account is created with a generated password emailed to the new user.

• Show Confirm Password FieldDefaultOff

  Ask for the password a second time, so a typing slip is caught before the account is created.

  Shown when Show Password Field is on

• Show Website FieldDefaultOff

  Ask for a web address and save it on the new account.

• Show Phone FieldDefaultOff

  Collects a contact number, stored on the new account as the canvas_phone user meta.

Labels

• First Name LabelDefaultFirst Name

  Wording of the label above the first name box.

  Shown when Show First Name Field is on

• Last Name LabelDefaultLast Name

  Wording of the label above the last name box.

  Shown when Show Last Name Field is on

• Username LabelDefaultUsername

  Wording of the label above the username box, for a design that says "Choose a Username".

  Shown when Show Username Field is on

• Email LabelDefaultEmail Address

  Wording of the label above the email box.

• Password LabelDefaultPassword

  Wording of the label above the password box.

  Shown when Show Password Field is on

• Confirm Password LabelDefaultConfirm Password

  Wording of the label above the second password box, for a design that says "Re-enter Password".

  Shown when Show Confirm Password Field is on

• Website LabelDefaultWebsite

  Wording of the label above the web address box.

  Shown when Show Website Field is on

• Phone LabelDefaultPhone

  Wording of the label above the telephone box.

  Shown when Show Phone Field is on

Layout

• LayoutDefaultClassic (paired fields)

  Classic sets the name, username and email boxes side by side in pairs. Modern stacks every box full width inside a shadowed card.

  ChoicesClassic (paired fields)Modern (stackedshadowed card)

• Heading TagDefaultH3

  Which heading level the title uses, so the form sits correctly in the page outline for search engines and screen readers.

  ChoicesH2H3H4H5

• No CardDefaultOff

  Drop the card and its body padding, for a design that places the form straight into its own column.

• Button StyleDefaultDark

  The look of the submit button: solid dark, raised black, or an outline only. Ignored by the Modern layout, which always uses its own black button.

  ChoicesDark3D BlackBordered

• Button Extra ClassesDefaultEmpty

  Utility classes appended to the submit button.

• Full-Width ButtonDefaultOff

  Stretch the submit button across the whole form instead of sizing it to its wording.

• Form Extra ClassesDefaultEmpty

  Class names added to the form itself, for spacing or a grid a design applies at that level.

• Field ID PrefixDefaultEmpty

  Prefix for the field ids and the form id. Empty generates a unique one.

• Field Column ClassesDefaultEmpty

  Grid column on EVERY field, replacing the layout's own pairing: a design that stacks all fields full width states it once here.

• Button Type AttributeDefaultsubmit

  Whether the button submits the form on its own. Choose button or omit it when your own script sends the form instead.

  ChoicessubmitbuttonOmit the attribute

• Button IDDefaultEmpty

  A name of your own for the button, so a stylesheet or a script can find this one button on the page.

• Button NameDefaultEmpty

  Key the button is submitted under, for a receiving script that needs to tell which button was pressed.

• Button ValueDefaultEmpty

  Value submitted alongside the button name. Only useful when a name is set.

• Submit Row ClassesDefaultcol-12 form-group mb-0

  Class names on the row holding the submit button, setting its width and the space below it.

Advanced

• Log the New User InDefaultOff

  Start a session for the account as soon as it is created.

• Message When Already Logged InDefaultYou are already logged in.

  Shown in place of the form to a visitor who is signed in.

• Message When Registration Is ClosedDefaultUser registration is currently disabled.

  Shown in place of the form while your site is not accepting new registrations.

Related

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Canvas: Alerts, Buttons, Code Highlight, Counters, Dividers, Dropcaps.