Text variables (Page Builder)

Text variables make the content of Page Builder modules dynamic. For example, they can save you the effort of looking up and entering project IDs and space keys in module settings. Additionally, you don't have to update text and settings when you make changes to your site, or when you export/import landing page layouts.

Add text variables in a module’s title or body text

Click a module’s heading or body text to edit it.
In your text, write the variable where you’d like to show dynamic content.

Text variable

Effect

$username

$userfullname

$userfirstname

Shows the current user’s username, full name, or first name. These names are set up in users' Atlassian accounts. For example, write “Welcome, $username” to personally welcome a user to your intranet.

$sitename

Shows the name of the site, as set up in the site’s configuration. For example, write “Welcome to $sitename” to welcome a user to your support site.

$structurename

Shows the name of the current page, as set up in the Site Builder. For example, write “Your requests on $structurename” in the title of a My Requests module.

Add text variables in a module’s settings

Jira Issues module

Filter by Project field:

Is the module placed on a Refined page? Enter $projectids to show issues from all Jira projects that are grouped under this Refined Page in the Site Builder.
Is the module placed on Jira project landing page? Enter $projectid to show issues from only that specific project.

Issue Types module

Project ID field:

Is the module placed on a Refined page? Enter $projectids to show issue types from all Jira projects that are grouped under this Refined Page in the Site Builder.
Is the module placed on Jira project landing page? Enter $projectid to show issue types from only the landing page’s Jira project.

Request Types module

JSM Portal ID field:

Is the module placed on a Refined page? Enter $servicedeskids to show request types from all JSM projects that are grouped under this Refined Page in the Site Builder.
Is the module placed on a JSM project landing page? Enter $servicedeskid to show request types from only the landing page’s JSM project.

My Requests module

Service desk ID field:

Is the module placed on a Refined page? Enter $servicedeskids to show requests from all JSM projects that are grouped under this Refined Page in the Site Builder.
Is the module placed on a JSM project landing page? Enter $servicedeskid to show requests from only the landing page’s JSM project.

Pages module

Filter by Space field:

Is the module placed on a Refined page? Enter $spacekeys to show pages from all spaces that are grouped under the Refined Page in the Site Builder.
Is the module placed on a Confluence space landing page? Enter $spacekey to show pages from only the landing page’s Confluence space.

Activity Stream module

Filter by Space field:

Is the module placed on a Refined page? Enter $spacekeys to show activity on pages from all spaces that are grouped under the Refined Page in the Site Builder.
Is the module placed on a Confluence space landing page? Enter $spacekey to show activity on pages from only the landing page’s Confluence space.

Filter by contributor field: enter $userid to show only activity from the current user.

News module

Filter by Space field:

Is the module placed on a Refined page? Enter $spacekeys to show blog posts from all spaces that are grouped under the Refined Page in the Site Builder.
Is the module placed on a Confluence space landing page? Enter $spacekey to show blog posts from only the landing page’s Confluence space.

Filter by author field: enter $userid to show only blog posts created by the current user.

Advanced: text variables in CQL and JQL

These variables can be used a module’s Filter with CQL or Filter with JQL field:

Text variable	Description
$username	The current user’s username.
$userFullName	The current user’s full name.
$userFirstName	The current user’s first name.
$siteName	The site’s name.
$structureName	The name of the current page, as set up in the Site Builder.
$serviceDeskId Only available on JSM project landing pages.	The service desk ID of a JSM project
$serviceDeskIds	A list of JSM project IDs that belong to this page’s child pages.
$siteServiceDeskIds	A list of all JSM project IDs that are connected to the site.
$spaceKey Only available on Confluence space landing pages.	The Confluence space key.
$spaceKeys	A list of the space keys that belong to this page’s child pages.
$siteSpaceKeys	A list of all Confluence space keys connected to the site.
$projectId Only available on Jira project landing pages.	The Jira project ID.
$projectIds	A list of Jira project IDs that belong to this page’s child pages.
$siteProjectIds	A list of all Jira project IDs that are connected to the site.
$projectKey Only available on Jira project landing pages.	The Jira project key.
$userId	The current user’s account ID.