Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Text variables make the content of Page Builder 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. Additionally, 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.

Table of Contents

...

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

$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 Buildersite structure. For example, write “Your requests on $structurename” in the title of a My Requests module.

Widget Connector
width720
urlhttps://vimeo.com/927877672
height405

...

Add text variables in a module’s settings

Jira Issues module

Filter by Project field (when Filter is set to Basic):

Excerpt
nameJira issues
  • Is the module placed on a Refined page? Enter $projectids to show issues from all Jira Software projects that are grouped under this Refined Page in the Site Buildersite structure.

  • Is the module placed on Jira Software project landing page? Enter $projectid to show issues from only that specific project.

Issue Types module

Project ID field:

Excerpt
nameIssue types
  • Is the module placed on a Refined page? Enter $projectids to show issue types from all Jira Software projects that are grouped under this Refined Page in the Site Buildersite structure.

  • Is the module placed on Jira Software project landing page? Enter $projectid to show issue types from only the landing page’s Jira Software project.

Request Types module

JSM Portal ID field:

Excerpt
nameJSM portal ID
  • 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 Buildersite structure.

  • Is the module placed on a JSM project landing page? Enter $servicedeskid to showrequest types from only the landing page’s JSM project.

My Requests module

Service desk ID field:

Excerpt
nameMy requests
  • 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 Buildersite structure.

  • Is the module placed on a JSM project landing page? Enter $servicedeskid to showrequests from only the landing page’s JSM project.

Pages module

Filter by Space field:

Excerpt
namePages
  • 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 Buildersite 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:

Excerpt
nameActivity stream
  • 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 Buildersite 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 from on documents that the current user has worked on.

News module

Filter by Space field:

Excerpt
nameNews
  • 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 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

$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 Buildersite 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 Software project landing pages.

The Jira Software project ID.

$projectIds

A list of Jira Software project IDs that belong to this page’s child pages.

$siteProjectIds

A list of all Jira Software project IDs that are connected to the site.

$projectKey

Only available on Jira Software project landing pages.

The Jira Software project key.

$userId

The current user’s account ID.

...