Create a custom condition
A condition allows you to filter an experience or experiment based on real-time visitor behavior.
If you're familiar with JavaScript, you can manually build a custom condition by writing your own logic. You can either modify an existing out-of-the box or custom condition, or build a new one entirely from scratch.
Users with a User, Developer, or Admin app role in Sitecore Cloud Portal can create custom conditions. These conditions can be created manually or with the help of the Code Assistant .
If your organization also has a SitecoreAI license, you can create custom conditions in both Sitecore Personalize and the SitecoreAI Page Builder. Custom conditions created in Sitecore Personalize are also available when you specify variables for conditions in SitecoreAI.
Before you start, we recommend you familiarize yourself with the following topics:
To create a custom condition manually:
-
On the navigation menu, click Developer center > Conditions.
-
Click Create. Alternatively, you can duplicate and edit an existing condition.
-
Enter a name for the new condition and click Create.
-
In the code editor, click Edit
and configure the JavaScript. To automatically format and indent the JavaScript code, click Format JS 
.We recommended that you return an object in the response body. You can copy code from another condition to help get you started.
TipThe value returned in the response can be accessed from the variant API response as 'filter'.
-
Click the Data tab in the right pane to copy a guest data model attribute or path and paste into the JavaScript editor. Click
and choose one of the following options:-
To view a random guest's attributes based on guest type, click in the search box and choose Quick Select Customer or Quick Select Visitor. The system selects a guest who was recently active.
-
To select fields from a specific guest, enter their unique identifier into the search box. For example, if you want to use segment membership as dynamic data, search for a guest who is a member of the segment. You can search for a guest using, for example, an email address, other unique identifier or browser ID.
TipIf there is a guest whose data you often use when configuring or testing code, click the star icon to bookmark the guest so you no longer have to search for them.
-
-
As you define input parameters in the JavaScript coding pane, the parameter names display in the Configuration tab.
-
Click Save to apply your changes. After saving your custom condition, make sure to define the condition output using the appropriate parameter names.
Define the condition output
The condition output is a combination of descriptive phrases and input parameters. This is what a user will see when they select a condition to apply to an experiment or experience, as shown below:
"The visit has / has not started on a page that compares to page during the current visit"
In this example, has / has not, compares to, and page are input parameters that the user will select values for when they apply the condition to an experiment or experience. We recommend that you phrase the condition output in a way that's similar to how you would structure a sentence.
To define the condition output:
-
In the Configuration tab, select the Output option.
-
Enter the text and the parameters in the Configure text box. This is the what the user will see when they apply the condition to the experiment or experience. As you type, the output displays in the Preview section. Valid parameters are bolded. To see the input parameter values that the user will be able to select from, click the Input option.
Parameters are case-sensitive and must be wrapped in double square brackets, for example:
[[path.name]].NoteYou must include all the condition parameters in the Configure text box, that are defined in the JavaScript coding editor. Parameters that are defined in the JavaScript but haven't been included in the Configure text box have a red exclamation mark. Click
to copy the parameter name and paste it into the Configure text box.Parameters that have been included in the Configure text box and are valid have a green checkmark.
This image shows that the has input parameter is defined in the JavaScript and has been included in the Configure text box. The green checkmark displays to indicate the input parameter was successfully included. The compares to parameter and page parameter have red exclamation marks because although they are included in the Configure text box, they are not wrapped in double square brackets and have an invalid syntax. To make the syntax valid and have the green checkmark display, wrap the parameters in double square brackets.
-
A preview of the condition output displays on the Configuration tab. This is useful to see how the user will view the condition when applying it to an experiment or experience. Click the Input option to view the parameter values that a user can select for the condition.
-
Click Test to test the condition using guest data. We recommend testing the condition before you publish it, to identify any errors and ensure optimal performance.