Skip to main content
Version: 1.3.0

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 projects, 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, projects, issue 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.

  • Purchase or renew: Settings → Billing → Manage subscriptions, or from the app entry in Manage apps.
  • Surface-by-surface detail: Atlassian Marketplace Licensing.
  • Commercial support: support@mbgroup.pe or your usual MB Group channels.

Automatic updates (Forge)​

Unlike Data Center plugins, Forge apps are updated automatically from Atlassian's infrastructure with no manual administrator intervention.

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.

Next steps

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