User Before Save trigger for Joomla

Overview

When it runs: Before a user record is saved (registration, admin user edit, profile save, API).

Plugins can modify user fields or prevent save; password may be present in the event.

Each run also includes who was logged in at the time and what kind of item was involved — see audit_user and audit_type in Payload Fields below.

This trigger is active when Platform Events are turned on in Joomla (System → JOrchestrator) and matching flows are set to Active.

When this trigger fires, JOrchestrator starts the flow and passes the incoming event or request data to the next connected step. Configure filtering, payload shape, and security on the Design tab.

Why use this node

User Before Save is a trigger in the Joomla Events › User Events group. Triggers start a flow. They listen for an external signal — a CMS event, inbound HTTP call, payment notification, or schedule — and pass the incoming data to the first downstream step.

Typical reasons teams add User Before Save to a flow:

Automate backend work when Joomla fires UserBeforeSave
Notify administrators or sync external systems on this CMS lifecycle event
Enrich or validate CMS data before it is persisted
Audit user, content, or extension activity without custom plugins

When it runs

Before a user record is saved (registration, admin user edit, profile save, API).

Example workflows

Common patterns on the canvas:

User Before Save → Send Notification (admin alert)
User Before Save → Insert Row (audit log)
User Before Save → If → Send Email / Update Article

Properties panel

The designer shows these tabs for this node:

Tab	Purpose
Info	Plain-language description and output payload fields for downstream steps
Design	Trigger configuration and payload schema

System (automatic — not edited by the user)

These fields are managed by the designer or runtime — you do not type into them directly:

Property key	Label	Type	Required	Visible when	Notes
`_nodeId`	Node ID	`node-id`	No	—	—

User-configured — General tab

Property key	Label	Type	Required	Visible when	Notes
`label`	Label	`text`	No	—	Node label

CMS site configuration (not on this node's properties panel)

Credentials, API keys, mailers, SMTP, and integration defaults are configured in the CMS plugin under Node Configuration, not per step on this node. Link the flow to a domain before testing CMS-backed fields.

Output payload fields

After this step runs, later nodes can reference these fields using placeholders such as {{user_before_save.subject.id}}.

Field key	Type	Description
`subject.id`	number	Nested field "subject.id" from this node's output payload.
`subject.username`	string	Nested field "subject.username" from this node's output payload.
`subject.email`	string	Nested field "subject.email" from this node's output payload.
`subject.name`	string	Nested field "subject.name" from this node's output payload.
`isNew`	boolean	Boolean flag from this node's output.
`data.id`	number	Nested field "data.id" from this node's output payload.
`data.username`	string	Nested field "data.username" from this node's output payload.
`data.email`	string	Nested field "data.email" from this node's output payload.
`data.name`	string	Nested field "data.name" from this node's output payload.
`audit_user.id`	number	Nested field "audit_user.id" from this node's output payload.
`audit_user.username`	string	Nested field "audit_user.username" from this node's output payload.
`audit_user.email`	string	Nested field "audit_user.email" from this node's output payload.
`audit_user.name`	string	Nested field "audit_user.name" from this node's output payload.
`audit_user.guest`	boolean	Nested field "audit_user.guest" from this node's output payload.
`audit_user.client`	string	Nested field "audit_user.client" from this node's output payload.
`audit_type`	string	What kind of item triggered the event — for example article, category, or user.

Related nodes

Other steps in the same area of the palette:

User After Delete (event-onUserAfterDelete) — Joomla Events › User Events
User After Login (event-onUserAfterLogin) — Joomla Events › User Events
User After Save (event-onUserAfterSave) — Joomla Events › User Events
User Authenticate (event-onUserAuthenticate) — Joomla Events › User Events
User Authorisation (event-onUserAuthorisation) — Joomla Events › User Events

User Before Save for Joomla