IsNew

Determines whether the current record is new and has not been saved yet. Use this when creating a new record to set default values or trigger actions.

Syntax

IsNew()

Enabled For

For a description of the business object categories, see Notes on "Enabled For".

Business Object Category	Yes/No
Business Rules: Before-Save Rules	Yes
Business Rules: Calculation Rules (After Save, with or without Also Recalculate on Load)	Yes
Business Rules: Calculation Rules (Before Save or Always, without Also Recalculate On Load)	Yes
Business Rules: Calculation Rules (Before Save or Always, with Recalculate On Load)	Yes
Business Rules: Editing Rules	Yes
Business Rules: Initialization Rules	Yes
Business Rules: Read Only Rules	No
Business Rules: Required Rules	Yes
Business Rules: Validation Rules	Yes
Client Expressions	No
Object Permissions	No
Services	Yes
LDAP	Yes
Mobile	Yes
Quick Actions (except UI Quick Actions)	Yes
UI Quick Actions	No
Reports	Yes
Search/Dashboard without field references	Yes
Search/Dashboard with field references	Yes

Parameters

None.

Return Value

Boolean

•True if the record is new (being created and not yet saved).

•False if the record already exists in the system.

Example

The following example demonstrates how to use the IsNew() function to set a default priority when creating a new Incident.

$(If(IsNew(), "Priority = 'Medium'", ""))

If the application returns True when a new Incident is being created, so the Priority is set to Medium.

If the application returns False when the Incident already exists and the field value remains unchanged.