This node updates the properties of a user account.
The Set User Properties node modifies the currently logged-in user or a specific user record.
The Set User Properties node is a specialized utility for updating user data. It automatically exposes fields from the _User system collection (like email, username, and custom fields). It is safer and more specific than the generic Set Record Properties node when dealing with user accounts.
General
| Data | Description |
|---|
| Email | Update the user's email address. |
| Username | Update the user's username. |
Properties
| Data | Description |
|---|
| * | Dynamic inputs for custom fields defined in your _User collection (e.g., "phoneNumber", "avatar"). |
Actions
| Signal | Description |
|---|
| Do | Triggers the update operation. |
Outputs
Events
| Signal | Description |
|---|
| Success | Triggered when the user properties are successfully updated. |
| Failure | Triggered if the update fails (e.g., invalid email, username taken). |
Error
| Data | Description |
|---|
| Error | Error message if the operation failed. |
Usage
Updating Profile
- Connect a Text Input to the Username port.
- Connect a Text Input to the Email port.
- Connect a "Save Profile" button to Do.
Detailed Behavior
- Scope: By default, this operates on the current user session.
- Validation: The backend will validate email format and username uniqueness.
- Security: Users can generally only update their own properties unless specific cloud functions or admin roles are involved.
Troubleshooting
- Permission Denied: Ensure the user is logged in. You cannot update user properties anonymously.
- Username Taken: If the Failure signal fires, check the Error output. It often indicates a duplicate username or email.