Skip to main content
Version: Next

Installation Guide

Installing Admin Essentials for Jira on your Jira Cloud instance is done directly from the Atlassian Marketplace. Follow this guide for a correct setup and to activate your license or free trial.

Prerequisites​

  • You must have Jira Administrator or Site Administrator permissions to install apps on your tenant.
  • An active internet connection and access to your Jira Cloud instance (your-domain.atlassian.net).
  • Jira Service Management (JSM) compatibility: The add-on's custom fields work in JSM spaces, including the agent view and the customer portal.

Admin Essentials for Jira on Atlassian Marketplace

Installation steps (Administrators)​

Follow these instructions to enable the add-on across your organization:

  1. Sign in: Access your Jira Cloud instance (e.g. your-domain.atlassian.net) with administrator credentials.
  2. Explore apps: In the left navigation, open the Apps menu and select Explore more apps or Find new apps.
  3. Search: In the Marketplace search bar, type Admin Essentials for Jira and press Enter, or open the Marketplace listing directly.
  4. Select the app: Open the Admin Essentials for Jira listing published by MB Group.
  5. Start trial or purchase: Click Try it free or Buy now as appropriate.
  6. Confirm permissions: Review the requested scopes and confirm with Start free trial, Accept & install, or the equivalent button.
  7. Verify: In Jira, go to Apps → Manage apps and confirm Admin Essentials for Jira is installed.
Required scopes

The app requests read permissions on fields, contexts, spaces, work types, and priorities, plus read/write permissions on contextual configuration of custom fields (to persist Traffic Light KPI thresholds per context). All scopes follow Forge's least-privilege principle.

Not an administrator?​

If you don't have admin privileges, Atlassian lets you suggest useful tools:

  1. Complete steps 2–4 above.
  2. Select Try it free, then click Submit request.
  3. Optionally add a message explaining why the add-on will benefit your team.
  4. Your administrator will receive a notification to review and approve installation.

Atlassian Marketplace and billing​

1. Free trial​

Paid Marketplace apps typically offer a 30-day free trial with full functionality, equivalent to an active license.

2. Pricing tiers​

  • User-based: Cost is calculated from your Jira site's total user count (user tier), not per individual use of the add-on.
  • Cloud Free plan: On sites with up to 10 users, many apps are free or low-cost depending on tier.

3. Centralised billing​

Atlassian consolidates app charges on the same invoice as your Jira subscription. You don't need separate payments to MB Group.

Official resources

Licensing and support​

From version 4.0.0, the app requires an active Marketplace license to edit fields, configure contexts, and create or modify validators. Data already stored remains visible without a license.

Automatic updates (Forge)​

Unlike Data Center plugins, Forge apps are updated automatically from Atlassian's infrastructure with no manual administrator intervention. Exception: the upgrade to 1.7.0 (Forge 6.0.0) is not silent; it requires Update and re-consent, as described below.

Permission changes

If a future version introduces new scopes, Atlassian will notify you and request explicit approval before applying the update. Versions that don't change permissions are applied transparently.

Upgrading to version 1.7.0 / Forge 6.0.0 — action required​

Re-consent required for 1.7.0

Version 1.7.0 (Forge 6.0.0) introduces a major Forge version change that incorporates the Forge Object Store module. This change requires two actions from the site administrator:

  1. Update the installation: In Jira, go to Apps → Manage apps, locate Admin Essentials for Jira, and click Update to apply the new version.
  2. Re-consent: After the update, Atlassian will prompt you to review and accept the app's permissions again. Confirm the consent to make the new modules (Attachment Field and Workflow Condition) fully operational.

The update is compatible with all existing field and validator configurations from version 1.6.0. New modules are configured from scratch.

Next steps

Once installed, visit the Administrator Guide to configure your first custom fields and validators.

Last updated on