Custom Registration Data

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. 
Adding registration fields in the Passage Console.
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:
1
GET /v1/apps/:appID/users/:userID
2
{
3
    "user": {
4
        "created_at": "2022-04-29T15:18:14.116026Z",
5
        "updated_at": "2022-04-29T15:18:49.229327Z",
6
        "status": "active",
7
        "id": "9DeEXvYBStnzwQcHFd6f558L",
8
        "email": "[email protected]",
9
        "phone": "",
10
        "webauthn": false,
11
        "webauthn_devices": [],
12
        "last_login_at": "2022-04-29T15:18:49.228759Z",
13
        "login_count": 1,
14
        "user_metadata": {
15
            "first_name": "anna",
16
            "last_name": "pobletts"
17
        }
18
    }
19
}
Copied!
User metadata can also be updated via the management API or SDK.
Node.js
Python
Go
Ruby
1
import Passage from "@passageidentity/passage-node";
2
import express from "express";
3
​
4
const app = express();
5
const port = 3000;
6
​
7
let passageConfig = {
8
  appID: "YOUR_APP_ID",
9
  apiKey: "YOUR_API_KEY",
10
};
11
let passage = new Passage(passageConfig);
12
​
13
// example authenticated route
14
app.get("/authenticatedRoute", passageAuthMiddleware, async (req, res) => {
15
  // get passage user ID from middleware
16
  let userID = res.userID;
17
  let newAttributes = {
18
    // note that user_metadata is an optional field and is defined in 
19
    //your Passage App settings.
20
    user_metadata: {
21
      "examplefield": 123,
22
    }
23
  };
24
​
25
  // update user attributes
26
  let passageUser = await passage.user.update(userID, newAttributes);
27
  console.log(passageUser);
28
});
Copied!
1
from passageidentity import Passage
2
​
3
psg = Passage(PASSAGE_APP_ID, PASSAGE_API_KEY)
4
​
5
# Get Passage User ID from database
6
# ...
7
​
8
# update a user custom field
9
psg.updateUser(user_id, {
10
    "user_metadata": {
11
        "first_name": "hannah"
12
    }
13
})
Copied!
1
import (	
2
	"net/http"
3
	
4
	"github.com/passageidentity/passage-go"
5
)
6
​
7
func exampleHandler(w http.ResponseWriter, r *http.Request) {
8
​
9
  psg, _ := passage.New("<PASSAGE_APP_ID>", &passage.Config{
10
    APIKey: "<PASSAGE_API_KEY>",
11
  })
12
​
13
  // Get the Passage User ID from database
14
  
15
  // The passageUserID returned above can be used deactivate a user
16
  userUpdateAttributes := UpdateBody{
17
    UserMetadata: map[string]interface{}{
18
			"example1": "123",
19
		},
20
  }
21
  passageUser, err := psg.updateUser(passageUserID, userUpdateAttributes)
22
  if err != nil {
23
    // 😔 failed to update the user
24
    w.WriteHeader(http.StatusInternalServerError)
25
    return
26
  }
27
​
28
}go
Copied!
1
require 'passageidentity'
2
​
3
PassageClient = Passage::Client.new(
4
  app_id: PASSAGE_APP_ID, 
5
  api_key: PASSAGE_API_KEY
6
)
7
​
8
user = PassageClient.user.update(
9
  user_id: user_id,
10
  user_metadata: {
11
    'example1': 'lame'
12
  }
13
)
14
​
Copied!
​

Guides - Previous

Multi-Device Testing with ngrok

Next - 🧑‍💻 Passage for Web

Passage Elements

Last modified 1mo ago

Copy link

Contents

Adding User Fields

Access Fields on the User Model