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 include:

• Space

• Content (pages and blogs)

• Comment

• Task

• User

• Label

Space properties

{{space}} – returns all available space properties

• {{space.url}}

• {{space.id}}

• {{space.key}}

• {{space.name}}

• {{space.isPersonal}}

• {{space.creator}}

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

Personal space

{{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.

Creator

{{space.creator}} – the person who created the space

Content properties (pages and blogs)

Page

{{page}} – Returns all available page properties

• {{page.url}}

• {{page.id}}

• {{page.title}}

• {{page.parent.url}}

• {{page.parent.id}}

• {{page.parent.title}}

• {{page.author.fullName}}

• {{page.author.publicName}}

• {{page.author.emailAddress}}

• {{page.author.accountId}}

• {{page.author.timeZone}}

• {{page.editor.fullName}}

• {{page.editor.publicName}}

• {{page.editor.emailAddress}}

• {{page.editor.accountId}}

• {{page.editor.timeZone}}

• {{page.owner.fullName}}

• {{page.owner.publicName}}

• {{page.owner.emailAddress}}

• {{page.owner.accountId}}

• {{page.owner.timeZone}}

• {{page.priorOwner.fullName}}

• {{page.priorOwner.publicName}}

• {{page.priorOwner.emailAddress}}

• {{page.priorOwner.accountId}}

• {{page.priorOwner.timeZone}}

• {{page.labels}}

• {{page.dateFirstPublished}}

• {{page.dateLastUpdated}}

• {{page.status}}

• {{page.state}} 

• {{page.aiSummary}}

• {{page.aiActionItems}}

Blog posts

{{blogpost}} – Returns all available blog post properties

• {{blogpost.url}}

• {{blogpost.id}}

• {{blogpost.title}}

• {{blogpost.parent.url}}

• {{blogpost.parent.id}}

• {{blogpost.parent.title}}

• {{blogpost.author.fullName}}

• {{blogpost.author.publicName}}

• {{blogpost.author.emailAddress}}

• {{blogpost.author.accountId}}

• {{blogpost.author.timeZone}}

• {{blogpost.editor.fullName}}

• {{blogpost.editor.publicName}}

• {{blogpost.editor.emailAddress}}

• {{blogpost.editor.accountId}}

• {{blogpost.editor.timeZone}}

• {{blogpost.labels}}

• {{blogpost.dateFirstPublished}}

• {{blogpost.dateLastUpdated}}

• {{blogpost.status}}

• {{blogpost.state}} 

• {{blogpost.aiSummary}}

• {{blogpost.aiActionItems}}

Content

{{content}} – Returns all available content properties

• {{content.type}}

• {{content.url}}

• {{content.id }}

• {{content.title}}

• {{content.parent.id}}

• {{content.parent.url}}

• {{content.parent.title}}

• {{content.author.fullName}}

• {{content.author.publicName}}

• {{content.author.emailAddress}}

• {{content.author.accountId}}

• {{content.author.timeZone}}

• {{content.editor.fullName}}

• {{content.editor.publicName}}

• {{content.editor.emailAddress}}

• {{content.editor.accountId}}

• {{content.editor.timeZone}}

• {{content.owner.fullName}}

• {{content.owner.publicName}}

• {{content.owner.emailAddress}}

• {{content.owner.accountId}}

• {{content.owner.timeZone}}

• {{content.priorOwner.fullName}}

• {{content.priorOwner.publicName}}

• {{content.priorOwner.emailAddress}}

• {{content.priorOwner.accountId}}

• {{content.priorOwner.timeZone}}

• {{content.labels}}

• {{content.dateFirstPublished}}

• {{content.dateLastUpdated}}

• {{content.status}}

• {{content.state}} 

Content type

{{content.type}} – identifies the type of relevant content as either a “page” or a “blogpost”.
Example in an automated message: “Hey check out this {{content.type}}”

URL

{{page.url}} – the URL link to a specific page

{{page.parent.url}} – the URL link to a page’s parent page

{{blogpost.url}} – the URL link to a specific blog post

{{content.url}} – the URL link to a piece of content, whether it’s a page or a blog post

ID number

{{page.id}} – the ID number that uniquely identifies a page

{{page.parent.id}} – the ID number that uniquely identifies a page’s parent page

{{blogpost.id}} – the ID number that uniquely identifies a blog post

{{content.id}} – the ID number that uniquely identifies a piece of content, whether it’s a page or a blog post

Title

{{page.title}} – the published title of a page

{{page.parent.title}} – the published title of a page’s parent page

{{blogpost.title}} – the published title of a blog post

{{content.title}} – the published title of a piece of content, whether it’s a page or a blog post

{{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 For each CQL result (related entities) branch.  

Author

Name

{{page.author.fullName}} – the first and last name of the person who originally published the page (the “Full name” in their Atlassian account profile)

{{page.author.publicName}} – the public name of the person who originally published the page (the name or handle they use in public Atlassian forums like Community)

{{blogpost.author.fullName}} – the first and last name of the person who originally published the blog post (the “Full name” in their Atlassian account profile)

{{blogpost.author.publicName}} – the public name of the person who originally published the blog post (the name or handle they use in public Atlassian forums like Community)

{{content.author.fullName}} – the first and last name of the person who originally published the content, whether it’s a page or a blog post (the “Full name” in their Atlassian account profile)

{{content.author.publicName}} – the public name of the person who originally published the content, whether it’s a page or a blog post (the name or handle they use in public Atlassian forums like Community)

Email

{{page.author.emailAddress}} – the email address of the person who originally published the page

{{blogpost.author.emailAddress}} – the email address of the person who originally published the blog post

{{content.author.emailAddress}} – the email address of the person who originally published the content, whether it’s a page or a blog post

Time zone

{{page.author.timeZone}} – the time zone the person who originally published the page is in

{{blogpost.author.timeZone}} – the time zone the person who originally published the blog post is in

{{content.author.timeZone}} – the time zone the person who originally published the content is in, whether it’s a page or a blog post

Account ID

{{page.author.accountId}} – the account ID number of the person who originally published the page

{{blogpost.author.accountId}} – the account ID number of the person who originally published the blog post

{{content.author.accountId}} – the account ID number of the person who originally published the content, whether it’s a page or a blog post

Editor

Returns the first Editor listed under Page information (see … More actions, Advanced details). This can be the same person as the author or just the most recent person to make a change.

Name

{{page.editor.fullName}} – the first and last name of the person who published the most recent updates to the page (the “Full name” in their Atlassian account profile)

{{page.editor.publicName}} – the public name of the person who published the most recent updates to the page (the name or handle they use in public Atlassian forums like Community)

{{blogpost.editor.fullName}} – the first and last name of the person who published the most recent updates to the blog post (the “Full name” in their Atlassian account profile)

{{blogpost.editor.publicName}} – the public name of the person who published the most recent updates to the blog post (the name or handle they use in public Atlassian forums like Community)

{{content.author.fullName}} – the first and last name of the person who published the most recent updates to the content, whether it’s a page or a blog post (the “Full name” in their Atlassian account profile)

{{content.author.publicName}} – the public name of the person who published the most recent updates to the content, whether it’s a page or a blog post (the name or handle they use in public Atlassian forums like Community)

Email

{{page.editor.emailAddress}} – the email address of the person who published the most recent updates to the page

{{blogpost.editor.emailAddress}} – the email address of the person who published the most recent updates to the blog post

{{content.editor.emailAddress}} – the email address of the person who published the most recent updates to the content, whether it’s a page or a blog post

Time zone

{{page.editor.timeZone}} – the time zone the person who published the most recent updates to the page is in

{{blogpost.editor.timeZone}} – the time zone the person who published the most recent updates to the blog post is in

{{content.editor.timeZone}} – the time zone the person who published the most recent updates to the content is in, whether it’s a page or a blog post

Account ID

{{page.editor.accountId}} – the account ID number of the person who published the most recent updates to the page

{{blogpost.editor.accountId}} – the account ID number of the person who published the most recent updates to the blog post

{{content.author.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 post

Dates

You can control the format of date smart values by adding a format modifier.

{{page.dateFirstPublished}} – the date the page was originally published

{{page.dateLastUpdated}} – the date the page was most recently updated

{{blogpost.dateFirstPublished}} – the date the blog post was originally published

{{blogpost.dateLastUpdated}} – the date the blog post was most recently updated

{{content.dateFirstPublished}} – the date the content was originally published, whether it’s a page or a blog post

{{content.dateLastUpdated}} – the date the content most recently updated, whether it’s a page or a blog post

Inactive pages

{{inactivePages}} – a list of pages that haven’t been viewed in a given time. A page’s view history includes any time a comment is added or the page is updated.

Labels

{{page.labels}} – a list of URL links to all the labels on a page
See also: {{labels.url}}

Lifecycle

{{content.status}} – the progress of a page or blog post, as indicated by the content status at the top (for example Rough draft, In progress, and Ready for review).

{{priorContentStatus}} – the previous status of the page or blog post

{{content.state}} – the publication state of the page or blog post: either Draft, Current, Archived, or Deleted

Owner

The owner of the page is the author, by default, but ownership can be transferred. Blog posts do not have “owners,” but any of the {{page.owner.property}} smart values can also be used with {{content.owner.property}} to return the same value.

Name

{{page.owner.fullName}} – the first and last name of the person who owns the page (the “Full name” in their Atlassian account profile)

{{page.owner.publicName}} – the public name of the person who person who owns the page (the name or handle they use in public Atlassian forums like Community)

Email

{{page.owner.emailAddress}} – the email address of the person who owns the page

Time zone

{{page.owner.timeZone}} – the time zone the person who owns the page is in

Account ID

{{page.owner.accountId}} – the account ID number of the person who owns the page

Prior owner

The prior owner of the page is the previous owner of the page, if it has been transferred. If the page has never been transferred, this smart value will not return anything. Blog posts do not have “owners,” but any of the {{page.priorOwner.property}} smart values can also be used with {{content.priorOwner.property}} to return the same value.

Name

{{page.priorOwner.fullName}} – the first and last name of the person who previously owned the page (the “Full name” in their Atlassian account profile)

{{page.priorOwner.publicName}} – the public name of the person who person who previously owned the page (the name or handle they use in public Atlassian forums like Community)

Email

{{page.priorOwner.emailAddress}} – the email address of the person who previously owned the page

Time zone

{{page.priorOwner.timeZone}} – the time zone the person who previously owned the page is in

Account ID

{{page.priorOwner.accountId}} – the account ID number of the person who previously owned the page

AI

{{page.aiSummary}} - an AI generated summary of a page

{{page.aiActionItems}} - an AI generated list of action items of a page

{{blogpost.aiSummary}} - an AI generated summary of a blogpost

{{blogpost.aiActionItems}} - an AI generated list of action items of a blogpost

Comment properties (page and inline)

{{comment}} – Returns all available comment properties

• {{comment.url}}

• {{comment.id}}

• {{comment.body}}

• {{comment.author.fullName}}

• {{comment.author.publicName}}

• {{comment.author.emailAddress}}

• {{comment.author.timeZone}}

• {{comment.author.accoundId}}

• {{comment.dateAdded}}

• {{comment.dateLastEdited}}

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

Name

{{comment.author.fullName}} – the first and last name of the person who wrote the comment (the “Full name” in their Atlassian account profile)

{{comment.author.publicName}} – the public name of the person who wrote the comment (the name or handle they use in public Atlassian forums like Community)

Email

{{comment.author.emailAddress}} – the email address of the person who wrote the comment

Time zone

{{comment.author.timeZone}} – the time zone the person who wrote the comment is in

Account ID

{{comment.author.accountId}} – the account ID number of the person who wrote the comment

Dates

You can control the format of date smart values by adding a format modifier.

{{comment.dateAdded}} – the date the comment was added to the page

{{comment.dateLastEdited}} – the date the comment was most recently edited

Task properties

{{task}} – returns all available task properties

• {{task.id}}

• {{task.contentId}}

• {{task.body}}

• {{task.creator.fullName}}

• {{task.creator.publicName}}

• {{task.creator.emailAddress}}

• {{task.creator.timeZone}}

• {{task.creator.accountId}}

• {{task.assignee.fullName}}

• {{task.assignee.publicName}}

• {{task.assignee.emailAddress}}

• {{task.assignee.timeZone}}

• {{task.assignee.accountId}}

• {{task.resolver.fullName}}

• {{task.resolver.publicName}}

• {{task.resolver.emailAddress}}

• {{task.resolver.timeZone}}

• {{task.resolver.accountId}}

• {{task.dueDate}}

• {{task.status}}

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 particular task is on

Message body

{{task.body}} – the message body of the task that contains the assignment, assignee, and due date

People (creator, assignee, and resolver)

Name

{{task.creator.fullName}} – the first and last name of the person who added the task to the page and assigned it to someone (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 (the name or handle they use in public Atlassian forums like Community)

{{task.assignee.fullName}} – the first and last name of the person who was assigned a task (@ mention)

{{task.assignee.publicName}} – the public name of the person who was assigned a task (@ mention) (the name or handle they use in public Atlassian forums like Community)

{{task.resolver.fullName}} – the first and last name of the person who marked a task complete (@ mention)

{{task.resolver.publicName}} – the public name of the person who marked a task complete (@ mention) (the name or handle they use in public Atlassian forums like Community)

Email

{{task.creator.emailAddress}} – the email address of the person who added the task to the page and assigned it to someone

{{task.assignee.emailAddress}} – the email address of the person who was assigned a task (@ mention)

{{task.resolver.emailAddress}} – the email address of the person who marked a task complete (@ mention)

Time zone

{{task.creator.timeZone}} – the time zone the person who added the task to the page, and assigned it to someone, is in

{{task.assignee.timeZone}} – the time zone of the person who was assigned a task (@ mention)

{{task.resolver.timeZone}} – the time zone of the person who marked a task complete (@ mention)

Account ID

{{task.creator.accountId}} – the account ID number of the person who added the task to the page and assigned it to someone

{{task.assignee.accountId}} – the account ID number of the person who was assigned a task (@ mention)

{{task.resolver.accountId}} – the account ID number of the person who marked a task complete (@ mention)

Dates

You can control the format of date smart values by adding a format modifier.

{{task.dueDate}} – the task’s due date

{{task.dateAdded}} – the date an action item (whether or not it’s an assigned task) 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

{{attachment}}, {{attachment.title}} – The name of the attachment.

{{attachment.downloadLink}} – A web address to download the file.

{{attachment.mediaType}} – The file type of the attachment.

{{attachment.fileSize}} – The file size of the attachment.

{{content}} – The content the attachment was added to, either a page or a blogpost.

{{page}}, {{blogpost}} – The content the attachment was added to, specifying either a page or a blogpost.

{{space}} – The space the attachment is in.

User properties

{{user}} – Returns all available user properties

• {{user.fullName}}

• {{user.publicName}}

• {{user.emailAddress}}

• {{user.timeZone}}

• {{user.accountId}} 

Name

{{user.fullName}} – the first and last name of the user (the “Full name” in their Atlassian account profile)

{{user.publicName}} – the public name of the user (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

The initiator is the person who caused the automation rule to trigger.

{{initiator}} – returns all available initiator properties

• {{initiator.fullName}}

• {{initiator.publicName}}

• {{initiator.emailAddress}}

• {{initiator.timeZone}}

• {{initiator.accountId}} 

Name

{{initiator.fullName}} – the first and last name of the person who caused the automation rule to trigger (the “Full name” in their Atlassian account profile)

{{initiator.publicName}} – the public name of the person who caused the automation rule to trigger (the name or handle they use in public Atlassian forums like Community)

Email

{{initiator.emailAddress}} – the email address of the person who caused the automation rule to trigger

Time zone

{{initiator.timeZone}} – the time zone of the person who caused the automation rule to trigger

Account ID

{{initiator.accountId}} – the account ID number of the person who caused the automation rule to trigger

Label properties

{{label}} – returns all available properties for a label

• {{label.url}}

• {{label.id}}

• {{label.contentId}}

• {{label.name}}

{{labels} – returns all available properties for all labels

• {{labels.url}}

• {{labels.id}}

• {{labels.contentId}}

• {{labels.name}}

URL

{{label.url}} – the URL link to a specific label

{{labels.url}} – 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}} – 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}} – a list of names of all the labels that were added or removed