Smart values in Confluence automation

Smart values are dynamic variables that can make your rule more flexible. Each smart value is constructed using a specific syntax called dot notation inside double mustache brackets. It's written as a hierarchy, starting with a top-level object and followed by properties of that object, {{object.property.subProperty}}. Notice that multiword properties use camelCase capitalization.

When you’re trying to understand what a particular smart value might do, it can help to read them in reverse. For example:

{{page.title}} is "the title of the page" (that's relevant to your rule component).

{{page.parent.title}} is "the title of the parent (of the relevant) page”.

This is a list of smart values that can currently be used in Confluence automation rules, grouped by object and sorted by the properties available for that object. Not all objects have the same properties.

Objects in Confluence

• Space

• Content (pages and blogs)

• Comment

• Task

• Attachment

• Loom videos

• Label

• User

• Initiator

• Security alerts (Atlassian Guard)

Space properties

All available

{{space}}

• Returns ALL of the space’s available properties and subproperties

URL

{{space.url}}

• The URL link to the Overview of a specific space

ID number

{{space.id}}

• The ID number that uniquely identifies a space

Space key

{{space.key}}

• The keyword in the URL that serves as a unique identifier of a space

  • Example: http://confluence.atlassian.com/wiki/spaces/KEYWORD/pages

Name

{{space.name}}

• The name of the space

Creator

{{space.creator}}

• Returns ALL of the space creator’s available properties and subproperties

{{space.creator.fullName}}

• The first and last name of the person who created the space

  • Full name is the “Full name” in their Atlassian account profile

{{space.creator.publicName}}

• The public name of the person who created the space

  • Public name the name or handle they use in public Atlassian forums like Community

{{space.creator.emailAddress}}

• The email address of the person who created the space

{{space.creator.timeZone}}

• The time zone of the person who created the space

{{space.creator.accountId}}

• The account ID number of the person who created the space

Boolean values

{{space.isPersonal}}

• Boolean: returns True if the space a personal space and False if it’s not

  • This is useful, for example, if you want to exclude personal spaces from global rules

Content properties (pages and blogs)

All available

{{page}}
{{blogpost}}
{{content}}

• Returns ALL available properties and subproperties for a page, blog, or piece of content (whether it’s a page or blog)

{{pages}}

• Returns a list of all matching pages with all their available properties and subproperties

  • Can be used in components that follow a branch, but not components IN the branch

Content type

{{content.type}}

• Identifies the type of content as either a page or a blogpost

  • Example in an automated message: “Hey check out this {{content.type}}”

URL

{{page.url}}
{{blogpost.url}}
{{content.url}}

• The URL link to a page, blog, or piece of content (whether it’s a page or a blog)

{{page.parent.url}}

• The URL link to a page’s parent page

ID number

{{page.id}}
{{blogpost.id}}
{{content.id}}

• The ID number that uniquely identifies a page, blog, or piece of content (whether it’s a page or blog)

{{page.parent.id}}

• The ID number that uniquely identifies a page’s parent page

Title

{{page.title}}
{{blogpost.title}}
{{content.title}}

• The published title of page, blog, or piece of content (whether it’s a page or a blog)

{{page.parent.title}}

• The published title of a page’s parent page

{{cqlResult.title}}

• The published title of a piece of content that is returned as part of a CQL query

  • This is useful, for example, when configuring a branch: For each CQL result (related entities)

{{cqlResults}}

• Returns a list of all matching {{CQLresult}} objects

  • Can be used in components that follow a branch, but not components IN the branch

Author

{{page.author}}

• Returns ALL of the page author’s available properties and subproperties

{{page.parent.author}}

• Returns ALL of the parent page author’s available subproperties

{{page.author.fullName}}
{{blogpost.author.fullName}}
{{content.author.fullName}}

• The first and last name of the person who originally published the page, blog, or piece of content (whether it’s a page or blog)

  • Full name is the “Full name” in their Atlassian account profile

{{page.author.publicName}}
{{blogpost.author.publicName}}
{{content.author.publicName}}

• The public name of the person who originally published the page, blog, or piece of content (whether it’s a page or blog)

  • Public name is the name or handle they use in public Atlassian forums like Community

{{page.author.emailAddress}}
{{blogpost.author.emailAddress}}
{{content.author.emailAddress}}

• The email address of the person who originally published the page, blog, or piece of content (whether it’s a page or blog)

{{page.author.timeZone}}
{{blogpost.author.timeZone}}
{{content.author.timeZone}}

• The time zone of the person who originally published the page, blog, or piece of content (whether it’s a or page or blog)

{{page.author.accountId}}
{{blogpost.author.accountId}}
{{content.author.accountId}}

• The account ID number of the person who originally published the page, blog, or piece of content (whether it’s a page or a blog)

Editor

{{page.editor.fullName}}
{{blogpost.editor.fullName}}
{{content.editor.fullName}}

• The first and last name of the person who published the most recent updates to the page, blog, or piece of content (whether it’s a page or blog)

  • Full name is the “Full name” in their Atlassian account profile

{{page.editor.publicName}}
{{blogpost.editor.publicName}}
{{content.editor.publicName}}

• The public name of the person who published the most recent updates to the page, blog, or piece of content (whether it’s a page or blog)

  • Public name is the name or handle they use in public Atlassian forums like Community

{{page.editor.emailAddress}}
{{blogpost.editor.emailAddress}}
{{content.editor.emailAddress}}

• The email address of the person who published the most recent updates to the page, blog, or piece of content (whether it’s a page or blog)

{{page.editor.timeZone}}
{{blogpost.editor.timeZone}}
{{content.editor.timeZone}}

• The time zone the person who published the most recent updates to the page, blog, or content (whether it’s a page or blog) is in

{{page.editor.accountId}}
{{blogpost.editor.accountId}}
{{content.editor.accountId}}

• The account ID number of the person who published the most recent updates to the page

{{content.editor.accountId}}

• The account ID number of the person who published the most recent updates to the content (whether it’s a page or a blog)

Owner

{{deactivatedOwnerPages}}

• Returns a list of pages with owners who are deactivated

  • Can be used in components that follow a branch, but not components IN the branch

{{page.owner.fullName}}
{{content.owner.fullName}}

• The first and last name of the person who owns the page

  • Full name is the “Full name” in their Atlassian account profile

{{page.owner.publicName}}
{{content.owner.publicName}}

• The public name of the person who person who owns the page

  • Public name is the name or handle they use in public Atlassian forums like Community

{{page.owner.emailAddress}}
{{content.owner.emailAddress}}

• The email address of the person who owns the page

{{page.owner.timeZone}}
{{content.owner.timeZone}}

• The time zone of the person who owns the page

{{page.owner.accountId}}
{{content.owner.accountId}}

• The account ID number of the person who owns the page

{{page.priorOwner.fullName}}
{{content.priorOwner.fullName}}

• The first and last name of the person who previously owned the page

  • Full name is the “Full name” in their Atlassian account profile

{{page.priorOwner.publicName}}
{{content.priorOwner.publicName}}

• The public name of the person who previously owned the page

  • Public name is the name or handle they use in public Atlassian forums like Community

{{page.priorOwner.emailAddress}}
{{content.priorOwner.emailAddress}}

• The email address of the person who previously owned the page

{{page.priorOwner.timeZone}}
{{content.priorOwner.timeZone}}

• The time zone of the person who previously owned the page

{{page.priorOwner.accountId}}
{{content.priorOwner.accountId}}

• The account ID number of the person who previously owned the page

Dates

{{page.dateFirstPublished}}
{{blogpost.dateFirstPublished}}
{{content.dateFirstPublished}}

• The date the content (page or blog) was originally published

{{page.dateLastUpdated}}
{{blogpost.dateLastUpdated}}
{{content.dateLastUpdated}}

• The date the content (page or blog) was most recently updated

Boolean values

{{page.hasChildren}}

• Boolean: returns True if the page has nested (child) pages and False if it’s not

{{page.hasEmptyBody}}

• Boolean: returns True if the page is blank and False if it’s not (or if body content can't be accessed)

Labels

{{page.labels}}
{{blogpost.labels}}
{{content.labels}}

• Returns a list of URL links to all the labels on a page, blog, or piece of content (whether a page or blog)

• See also: {{labels.url}}

Lifecycle

{{page.state}}
{{blogpost.state}}
{{content.state}}

• The publication state of the page, blog, or piece of content (whether or not it’s a page or blog):
  either Draft, Current, Archived, or Deleted

{{page.status}}
{{blogpost.status}}
{{content.status}}

• The progress of a page, blog, or piece of content (whether or not it’s a page or blog), as indicated by the content status at the top (for example Rough draft, In progress, and Ready for review)

{{priorContentStatus}}

• The prior progress status of the page or blog

Page activity

{{page.totalViewersCount}}

• The total number of unique users who have viewed the page

{{page.totalViewsCount}}

• The total number of views the page has received

{{inactivePages}}

• Returns a list of pages that haven’t been viewed in a given time

  • Actions like commenting and updating the page count toward Views

Page classification

{{page.classificationLevel}}
{{blogpost.classificationLevel}}

• The classification level of a page or blog (for example Restricted, Internal, or Public)

Rovo actions

{{page.aiSummary}}
{{blogpost.aiSummary}}

• Returns a Rovo-generated summary of a page or blog

{{page.aiActionItems}}
{{blogpost.aiActionItems}}

• Returns Rovo-generated action items for a page or blog

Comment properties (page and inline)

All available

{{comment}}

• Returns ALL of the comment’s available properties and subproperties

URL

{{comment.url}}

• The URL link to a specific page or inline comment

ID number

{{comment.id}}

• The ID number that uniquely identifies a page or inline comment

Message body

{{comment.body}}

• The message body contained in the page or inline comment

Author

{{comment.author.fullName}}

• The first and last name of the person who wrote the comment

  • Full name is the “Full name” in their Atlassian account profile

{{comment.author.publicName}}

• The public name of the person who wrote the comment

  • Public name is the name or handle they use in public Atlassian forums like Community

{{comment.author.emailAddress}}

• The email address of the person who wrote the comment

{{comment.author.timeZone}}

• The time zone of the person who wrote the comment

{{comment.author.accountId}}

• The account ID number of the person who wrote the comment

Dates

{{comment.dateAdded}}

• The date the comment was added to the page

{{comment.dateLastEdited}}

• The date the comment was most recently edited

Task properties

All available

{{task}}

• Returns ALL of the task’s available properties and subproperties

{{tasks}}

• Returns a list of all matching tasks with ALL their available properties and subproperties

  • Can be used in components that follow a branch, but not components IN the branch

ID number

{{task.id}}

• The ID number that uniquely identifies a particular task (action item)

{{task.contentId}}

• The ID number that uniquely identifies the page a task is on

Message body

{{task.body}}

• The message body of the task that contains the assignment, assignee, and due date

Creator

{{task.creator.fullName}}

• The first and last name of the person who added the task to the page and assigned it to someone

  • Full name is the “Full name” in their Atlassian account profile

{{task.creator.publicName}}

• The public name of the person who added the task to the page and assigned it to someone

  • Public name is the name or handle they use in public Atlassian forums like Community

{{task.creator.emailAddress}}

• The email address of the person who added the task to the page and assigned it to someone

{{task.creator.timeZone}}

• The time zone of the person who added the task to the page and assigned it to someone

{{task.creator.accountId}}

• The account ID number of the person who added the task to the page and assigned it to someone

Assignee

{{task.assignee.fullName}}

• The first and last name of the person who was assigned a task (@mentioned)

  • Full name is the “Full name” in their Atlassian account profile

{{task.assignee.publicName}}

• The public name of the person who was assigned a task (@mentioned)

  • Public name is the name or handle they use in public Atlassian forums like Community

{{task.assignee.emailAddress}}

• The email address of the person who was assigned a task (@mentioned)

{{task.assignee.timeZone}}

• The time zone of the person who was assigned a task (@mentioned)

{{task.assignee.accountId}}

• The account ID number of the person who was assigned a task (@mentioned)

Resolver

{{task.resolver.fullName}}

• The first and last name of the person who marked a task complete

  • Full name is the “Full name” in their Atlassian account profile

{{task.resolver.publicName}}

• The public name of the person who marked a task complete

  • Public name is the name or handle they use in public Atlassian forums like Community

{{task.resolver.emailAddress}}

• The email address of the person who marked a task complete

{{task.resolver.timeZone}}

• The time zone of the person who marked a task complete

{{task.resolver.accountId}}

• The account ID number of the person who marked a task complete

Dates

{{task.dueDate}}

• The date a task is due to complete

{{task.dateAdded}}

• The date an action item (whether assigned or not) was added and published to the page or blog

{{task.dateLastEdited}}

• The date the task was most recently edited

{{task.dateCompleted}}

• The date an action item (whether or not it’s an assigned task) was completed

Lifecycle

{{task.status}}

• The progress of a task (either Complete or Incomplete)

Attachment properties

File type

{{attachment.mediaType}}

• The type of file attachment

URL

{{attachment.downloadLink}}

• A URL link to download the file attachment

Name

{{attachment}}
{{attachment.title}}

• The name of the file attachment

File size

{{attachment.fileSize}}

• The size of the file attachment

Location

{{page}}
{{blogpost}}
{{content}}

• The page, blog, or piece of content (whether a page or blog) that the file is attached to

{{space}}

• The space the attachment is in

Loom properties

URL

{{loomVideo.url}}

• A URL link to watch the Loom video

Title

{{loomVideo.title}}

• The title of the Loom video

Summary

{{loomVideo.summary}}

• Returns an AI-generated summary of the Loom video

Action items

{{loomVideo.actionItems}}

• Returns a list of AI-generated action items from the Loom video including the:

  • Email address of the user each action item is assigned to

  • Timestamp of where each action item was referenced in the video

{{loomVideo.actionItem.timestamp}}

• The timestamp in seconds of where an action item was referenced in a Loom video

{{loomVideo.actionItem.assignedUserEmail}}

• The email address of the user assigned to an action item from a Loom video

{{loomVideo.actionItem.text}}

• Plain text description of the action item from a Loom video

  • For example, “Follow up with sales team”

Transcript

{{loomVideo.transcript}}

• The Loom video transcript, with each string shown in markdown format

Creator

{{loomVideo.creator.accountID}}

• The account ID of the person who created the Loom video

{{loom.creator.emailAddress}}

• The email address of the person who created the Loom video

{{loom.creator.fullName}}

• The first and last name of the person who created the Loom video

  • Full name is the “Full name” in their Atlassian account profile

Dates

{{loomVideo.dateCreated}}

• The date the Loom video was recorded

Attendees

{{loomVideo.attendees}}

• Returns a list of email addresses of everyone who attended the (Loom recorded) meeting

{{loomVideo.attendee.emailAddress}}

• The email address of the person who attended the (Loom recorded) meeting

Boolean values

{{loom.isMeetingRecording}}

• Boolean: returns True if the Loom is a meeting recording and False if it isn’t

Label properties

All properties

{{label}}

• Returns ALL of the label’s available properties

{{labels}}

• Returns lists of all available properties for all labels

URL

{{label.url}}

• The URL link to a specific label

{{labels.url}}

• Returns a list of URL links of all the labels that were added or removed
  See also: {{page.labels}}

ID number

{{label.id}}

• The ID number that uniquely identifies a particular label

{{labels.id}}

• Returns a list of ID numbers of all the labels that were added or removed

{{label.contentId}}

• The ID number that uniquely identifies the page or blog a particular label is on

Name

{{label.name}}

• The name of the label

{{labels.name}}

• Returns a list of names of all the labels that were added or removed

User properties

All available

{{user}}

• Returns all of the user’s available properties

{{userAdded}}

• Returns all available user properties for a user who was added to a group

{{unassignedGuestUsers}}

• Returns a list of guest users who aren’t assigned to a space

  • Can be used in components following a branch, but not components IN the branch

Name

{{user.fullName}}

• The first and last name of the user

  • Full name is the “Full name” in their Atlassian account profile

{{user.publicName}}

• The public name of the user

  • Public name is the name or handle they use in public Atlassian forums like Community

Email

{{user.emailAddress}}

• The email address of the user

Time zone

{{user.timeZone}}

• The time zone the user is in

Account ID

{{user.accountId}}

• The account ID number of the user

Initiator properties (Automation rules)

All available

{{initiator}}

• Returns ALL available initiator properties

Name

{{initiator.fullName}}

• The first and last name of the person who initiated the trigger of an automation rule

  • Full name is the “Full name” in their Atlassian account profile

{{initiator.publicName}}

• The public name of the person who initiated the trigger of an automation rule

  • Public name is the name or handle they use in public Atlassian forums like Community

Email

{{initiator.emailAddress}}

• The email address of the person who initiated the trigger of an automation rule

Time zone

{{initiator.timeZone}}

• The time zone of the person who initiated the trigger of an automation rule

Account ID

{initiator.accountId}}

• The account ID number of the person who initiated the trigger of an automation rule

Detected alert properties (Atlassian Guard)

Alert type

{{detectAlert.type}}

• The type or alert that was detected (for example credit card numbers)

URL

{{detectAlert.url}}

• The URL link to view the detected alert (in Guard Detect)

{{detectAlert.workspace.url}}

• The URL link of the Guard Detect workspace that generated the detected alert

ID number

{{detectAlert.id}}

• The ID number that uniquely identifies the detected alert

Origin

{{detectAlert.product}}

• The product where the detected alert originated

{{detectAlert.workspace.ari}}

• Metadata (array) about the Guard Detect workspace where the detected alert originated

Detection details

{{detectAlert.detection.title}}

• The title of the detection that generated the alert

{{detectAlert.detection.category}}

• The category of detection that generated the alert

• (Used to differentiate content scanning and user activity detections)

{{detectAlert.detection.type}}

• The type of detection that generated the alert

• (Used to differentiate between system (core) and custom detections)

{{detectAlert.detection.ari}}

• Metadata (array) about the detection that generated the alert

Title

{{detectAlert.title}}

• The title of the detected alert

Message body

{{detectAlert.description.text}}

• Plain text description of the activity that triggered the detected alert

{{detectAlert.description.markdown}}

• Markdown format description of the activity that triggered the detected alert

{{detectAlert.investigationSteps.text}}

• Plain text description of the investigation steps for the detected alert

{{detectAlert.investigationSteps.markdown}}

• Markdown format description of the investigation steps for the detected alert

{{detectAlert.remediationOptions.text}}

• Plain text description of the remediation options for the detected alert

{{detectAlert.remediationOptions.markdown}}

• Markdown format description of the remediation options for the detected alert

Alert resources

{{detectAlert.linkedResources.ID}}

• The ID number that uniquely identifies any resource linked to the alert

{{detectAlert.linkedResources.URL}}

• The URL of any resource linked to the alert

Actor

{{detectAlert.actor.guardDetectProfileUrl}}

• The URL link for the Guard Detect actor profile of the person who performed the action that triggered the detected alert

{{detectAlert.actor.id}}

• The ID number that uniquely identifies the person who performed the action that triggered the detected alert

{{detectAlert.actor.displayName}}

• The first and last name of the person who performed the action that triggered the detected alert

  • Display name is the full name in their Atlassian account profile

{{detectAlert.actor.email}}

• The email address of the person who performed the action that triggered the detected alert

{{detectAlert.actor.profilePicture}}

• The profile picture of the person who performed the action that triggered the detected alert

{{detectAlert.actor.accountCreated}}

• The date an account was created for the person who performed the action that triggered the detected alert

{{detectAlert.actor.lastLoginTime}}

• The time the person who performed the action that triggered the alert last logged in (in ISO 8601 format)

{{detectAlert.actor.lastLoginLocation}}

• The geographic location of the person who performed the action that triggered the alert, when they last logged in

Timestamps

{{detectAlert.created}}

• The time the alert was created (in ISO 8601 format)

{{detectAlert.time.start}}

• The time the triggering activity started the alert (in ISO 8601 format)

{{detectAlert.time.end}}

• The time the final activity ended the alert (in ISO 8601 format)

Lifecycle

{{detectAlert.status}}

• Current status of the detected alert

Adding a smart value to a rule

When you’re building a rule with a component that accepts smart values, you can enter the smart value manually or use the search tool.

Smart value search tool

At the right side of the smart value field you will see a selectable mustache brackets {} icon. Select this to open a searchable list of all smart values in Confluence.

When you find the smart value you want, select the copy icon to copy the smart value to your clipboard.

Go back to the smart value input field and paste the value from your clipboard (Cmd + V on Mac or Ctrl + V on PC).