Documentation / Installation

Install VersionSelect

VersionSelect is a Jira Cloud app. A Jira administrator installs it, configures one catalog source for the installation, and places the Service & Version field on the required work types.

Email Fogsea for the available installation route for your Jira Cloud site.

1. Open the installation link supplied by Fogsea, or the VersionSelect Marketplace listing when available. Select the intended Jira site and review the requested permissions.
2. Open Manage apps → VersionSelect for Jira settings → Configure.
3. Choose Manual configuration to maintain options in Jira, or Backend API to connect an organization-approved catalog. API mode requires an active subscription or evaluation.
4. Add Service & Version to the relevant screens or work type layouts using the field configuration guide.
5. On a test work item, select a service and version, save, reopen the item, and confirm the value remains visible.

Permissions and data sources

The app declares only the Forge storage:app scope for installation-isolated configuration, secrets, manual catalogs, short-lived API caches, and automatic maintenance state. It does not request Jira work-item, project, or permission read access, build saved-field history, or backfill work items. Manual mode does not connect to an external catalog and remains available without an active app license.

Backend API mode needs an active subscription or evaluation and approval for the configured HTTPS origin. Without an active license, the app does not send catalog requests to that origin.

Installation scope

Configuration is shared across the app installation rather than configured per project. Development and production installations have separate settings and data. A DEV label identifies a development installation.