oo

Predefined Element Variables Reference

In the Element Source editor, place the cursor in the desired location and click the variable in the left hand sidebar to insert it. In the Custom JSON Element, you must type the variable directly into the editor. The syntax for each variable appears in the table below.

Variable Type: Definition Syntax
CONTEXT
Company ID Number: the company ID of the current instance ${context.company_id}
Is Staging Group Boolean: whether the current site is staged ${context.is_staging_group}
Language Text: the 2-letter code for the current language (e.g., en) ${context.language}
Language ID Text: the 4-letter language code (e.g., en_US) of the current language ${context.language_id}
Layout Name Localized Text: the localized name of the page ${context.layout-name-localized}
Page Layout ID Number: the ID of the page ${context.plid}
Publication ID Number: the publication ID ${context.publication_id}
Scope Group ID the current site’s ID ${context.scope_group_id}
TIME
Current Date Date: the current date ${time.current_date}
Current Day of Month Number: the day of the month ${time.current_day_of_month}
Current Day of Week Number: the day of the week (1 = Monday) ${time.current_day_of_week}
Current Day of Year Number: the day of the year ${time.current_day_of_year}
Current Hour Number: the current hour ${time.current_hour}
Current Year Number: the current year ${time.current_year}
Time of Day Time: the time ${time.time_of_day}
Time Zone Name Localized Text: the time zone, localized for the locale ${time.time_zone_name_localized}
USER
Active Segment Entry IDs Number: the user’s segment IDs ${user.active_segment_entry_ids}
Age Number: the user’s age in number of years ${user.age}
Asset Category Ids (Available 7.4 U41+) Number: the IDs of the user’s categories ${user.asset_category_ids}
Asset Tag Names (Available 7.4 U41+) Text: the user’s tags ${user.asset_tag_names}
Birthday Date: the user’s birth date ${user.birthday}
Create Date Date: the date when the user account was created in Liferay ${user.create_date}
Current Site Role IDs Number: the user’s site role IDs ${user.current_site_role_ids}
Email Domain Text: the user’s email domain ${user.email_domain}
First Name Text: the user’s first name ${user.first_name}
Full Name Text: the user’s full name ${user.full_name}
Group IDs Number: the IDs of sites the user is a member of ${user.group_ids}
User ID Number: the user’s ID ${user.id}
Is Female Boolean: true if the user is female ${user.is_female}
Is Gender X Boolean: true if the user is gender X ${user.is_gender_x}
Is Male Boolean: true if the user is male ${user.is_male}
Is Omniadmin Boolean: true if the user is the Omni Admin user (the default user of the default instance) ${user.is_omniadmin}
Is Signed In Boolean: true if the user is signed in ${user.is_signed_in}
Job Title Text: the user’s job title ${user.job_title}
Language ID Text: the user’s language code (e.g., en_US) ${user.language_id}
Last Name Text: the user’s last name ${user.last_name}
Parent Asset Category Ids (Available 7.4 U41+) Number: the IDs of all the parent categories of the user’s categories ${user.parent_asset_category_ids}
Regular Role IDs Number: the role IDs for the user’s regular roles ${user.regular_role_ids}
User group IDs Number: the IDs of the user groups that the user is part of ${user.user_group_ids}
CONDITIONAL ELEMENTS*
IP Stack City Text: the city where the searching IP address originates ${ipstack.city}
IP Stack Continent Code Text: the continent code (e.g., NA for North America) where the searching IP address originates ${ipstack.continent_code}
IP Stack Continent Name Text: the continent name ${ipstack.continent_name}
IP Stack Country Code Text: the country code (e.g., US for United States) ${ipstack.country_code}
IP Stack Country Name Text: the country name ${ipstack.country_name}
IP Stack Latitude Number: the latitude in decimal degrees ${ipstack.latitude}
IP Stack Longitude Number: the longitude in decimal degrees ${ipstack.longitude}
IP Stack Region Code Text: the region code (e.g., CA for California) ${ipstack.region_code}
IP Stack Region Name Text: the region name ${ipstack.region_name}
IP Stack Zip Code Number: the zip code ${ipstack.zip}
Open Weather Map Temperature Number: the temperature ${openweathermap.temp}
Open Weather Map Weather Description Text: a description of the weather (e.g., “clear sky”) ${openweathermap.weather_description}
Open Weather Map Weather ID Number: the ID corresponding to the weather description ${openweathermap.weather_id}
Open Weather Map Main Label Text: the primary identifier for the weather (e.g., Rain; this is the Main field in OpenWeatherMap’s API response, according to the weather ID ${openweathermap.weather_main}
Open Weather Map Wind Speed Number: the wind speed in km/h ${openweathermap.wind_speed}
User Custom Fields ** the value of a user custom field user.custom.field.[name]

* Activate Liferay Commerce to access the Commerce-specific variables.

* Access ipstack and OpenWeatherMap variables by first enabling each service. Visit System or Instance Settings → Platform → Search Experiences. Click the Enabled checkbox and save the configuration for the service you’re configuring. Note that the OpenWeatherMap service depends on the ipstack service being enabled. See Personalizing the Search Experience for an example using the ipstack service.

** In addition to these out-of-the-box variables, Custom Fields on the user entity can also be referenced as variables in the element. For example, a user custom field with the name Employee is referenced in an element with user.custom.field.employee.

Capability: