Text variables

Text variables make the content of landing page modules dynamic. For example, welcome a user to an intranet by name with the $username text variable. Additionally, they can save you the effort of looking up and entering project IDs and space keys in module settings. And 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

  1. Click a module’s heading or body text to edit it.

  2. In your text, write the variable where you’d like to show dynamic content.

Text variable

Effect

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

  • 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 structure.

  • 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 structure.

  • 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 structure.

  • 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 structure.

  • 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 structure.

  • 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 on documents that the current user has worked on.

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

  • 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

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

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