This module now has support for UI Kit 2 (preview) for faster user experiences and to access additional React features.

For more information on all the supported modules, see the Supported products and their modules section.

Confluence global page

The confluence:globalPage module displays content in place of a Confluence page. Each module appears as a link in the main navigation menu in Apps section, and the title of each module is used as the title of the link. When a user clicks a link, the corresponding Forge app renders inside the main content area of Confluence.

The page URL is constructed in the form of: /apps/:appId/:forgeEnvId/:route. You can configure :route in the manifest.

On apps that use Custom UI, module content is displayed inside a special Forge iframe which has the sandbox attribute configured. This means that HTML links (for example, <a href="https://domain.tld/path">...</a>) in this iframe won't be clickable. To make them clickable, use the router.navigate API from the @forge/bridge package.

Properties

Property	Type	Required	Description
`key`	`string`	Yes	A key for the module, which other modules can refer to. Must be unique within the manifest. Regex: `^[a-zA-Z0-9_-]+$`
`function`	`string`	The global page module requires a `function` for use with the UI kit or a `resource` when building with custom UI.	A reference to the function module that defines the Confluence global page app.
`resource`	`string`		A reference to the static `resources` entry that the global page displays. See resources for more details.
`render`	`'native'`	Yes for UI Kit 2	Indicates if the module is a UI Kit 2 module.
`resolver`	`{ function: string }` or `{ endpoint: string }`		Set the `function` property if you are using a hosted `function` module for your resolver. Set the `endpoint` property if you are using Forge remote (preview) to integrate with a remote back end. Can only be set if the module is using the `resource` property.
`title`	`string`	Yes	The title of the global page, which is displayed at the top of the page.
`icon`	`string`		The icon displayed next to the `title`. For custom UI and UI kit apps, the `icon` property accepts a relative path from a declared resource. Alternatively, you can also use an absolute URL to a self-hosted icon. See Icons for more information. If no icon is provided, or if there's an issue preventing the icon from loading, a generic app icon will be displayed.
`route`	`string`	Yes	A string of text that makes the URL of the browser more readable. Inside an app, each global page module must have a distinct `route`. Regex: `^[0-9a-z-]+$`
`displayConditions`	`object`		The object that defines whether or not a module is displayed in the UI of the app. See display conditions.
`keyboardShortcut`	`object`		The object that defines a keyboard shortcut to go to this page. See keyboard shortcuts.

Extension context

Custom UI

Property	Type	Description
`type`	`string`	The type of the module.

UI kit

Property	Type	Description
`type`	`string`	The type of the module.