Custom Registration Data

Add fields to your registration page - no code required.

Adding custom fields to your registration page is simple with Passage. Learn how to define your custom registration page, allow users to update their own profile data, and manage user data from your web application.

Adding User Fields

You can define the fields you want on your registration page in the Passage Console. Define a new field by giving it a display name and a type. The currently supported types are:

  • String

  • Date (MM/DD/YYYY)

  • Number

  • Boolean (renders as a checkbox)

  • Email

  • Phone number

Email and phone number types are strings that will have additional validation performed to ensure they are valid email addresses or phone numbers.

Fields also have a few settings associated with them to determine who can view and edit the fields:

  • On Registration: if checked, the field will show up on the register element by default and be required for new users.

  • Editable: if checked, the field will show up on the profile element by default and can be updated by a user via the element or Current User API.

Fields not marked as editable, will only be accessible via the Management API.

Use the designer console to resize and reorder the fields for your Register and Profile Elements. Once saved, these changes will immediately be reflected in your application.

Access Fields on the User Model

Once you've defined the schema for your custom user fields, you can access those user attributes via the Passage Management API and backend SDKs. All user objects will contain a user_metadata key which consists of a dictionary of field name and values based on the schema defined. If no metadata schema is defined, the user_metadata key will be {}. An example user response would look like this:

GET /v1/apps/:appID/users/:userID
    "user": {
        "created_at": "2022-04-29T15:18:14.116026Z",
        "updated_at": "2022-04-29T15:18:49.229327Z",
        "status": "active",
        "id": "9DeEXvYBStnzwQcHFd6f558L",
        "email": "[email protected]",
        "phone": "",
        "webauthn": false,
        "webauthn_devices": [],
        "last_login_at": "2022-04-29T15:18:49.228759Z",
        "login_count": 1,
        "user_metadata": {
            "first_name": "anna",
            "last_name": "pobletts"

User metadata can also be updated via the management API or SDK.

import Passage from "@passageidentity/passage-node";
import express from "express";

const app = express();
const port = 3000;

let passageConfig = {
  appID: "YOUR_APP_ID",
  apiKey: "YOUR_API_KEY",
let passage = new Passage(passageConfig);

// example authenticated route
app.get("/authenticatedRoute", passageAuthMiddleware, async (req, res) => {
  // get passage user ID from middleware
  let userID = res.userID;
  let newAttributes = {
    // note that user_metadata is an optional field and is defined in 
    //your Passage App settings.
    user_metadata: {
      "examplefield": 123,

  // update user attributes
  let passageUser = await passage.user.update(userID, newAttributes);

Last updated