跳到主内容

Sign-up items table

On the application configuration page, use the Sign-up items table to define which fields appear on the registration page. Add, remove, or reorder items to customize the form.

注册项目表

提示

Applications created via the Casdoor SDK get default signup items (ID, Username, Display name, Password, Confirm password, Email, Phone, Agreement). You can adjust them as needed.

Column reference

ColumnValues描述
NameName of the signup item.
可见True / FalseShow or hide on the registration page.
必填True / FalseWhether the field is mandatory.
提示True / FalseWhether to prompt the user if they leave it empty.
RegexOptional regex for client-side validation.
LabelFor items starting with Text, use HTML for the field; otherwise replaces the item label.
Custom CSSCSS for this signup item.
规则Rule itemsRule that customizes this item (see table below).
操作Move up, move down, or delete.

Items that support rules: ID, Display name, Email, Agreement.

ItemRules描述
IDRandom / IncrementalUser ID generation: random or incremental.
显示名称None / Real name / First, lastHow to show the display name; First, last shows first and last name separately.
电子邮件Normal / No verificationNormal = require email verification; No verification = skip verification.
协议None / Signin / Signin (Default True)Terms of use: none, require confirmation, or default to confirmed.
备注

Example: to show an email field without verification, add the Email signup item and set its rule to No verification.

Signup Items Table

注册项目表

备注

If the organization has "Use email as username" enabled and the username field is hidden in signup items, the user’s email is used as their username.

Field validation

Use the Regex column to validate input on the client before submit:

  1. Set Regex on the signup item (e.g. Username, Display name, or a custom field).
  2. Enter a pattern (e.g. ^[a-zA-Z0-9_]+$ for alphanumeric usernames).
  3. Users see an error when input does not match.

Works for standard fields (Username, Display name, First name, Last name, Affiliation) and custom fields.