SmartLists for Jira Installation

Installing from the Atlassian Marketplace

You need to be a Jira administrator.

  1. Log in to your instance as an admin.

  2. Select the Apps dropdown from the top navigation bar and choose Explore new apps.

  3. Type SmartLists for Jira in the search bar.

  4. Select the app tile to open its details page.

  5. Select Try it Free to install.

  6. A success message confirms the install. You can start using the app straight away.

If you are not a Jira administrator, you can still select Try it Free on the Atlassian Marketplace and then choose Submit request. This tells your Jira administrator that you would like to try SmartLists for Jira.

The permissions prompt

During installation, Jira asks you to approve three permissions:

Permission

What the app does with it

Read Jira work

Lists the work types in your project so you can restrict a panel to some of them; runs template JQL conditions to decide which template applies; reads the list of files already attached to a work item for File columns

Write Jira work

Saves SmartList rows onto the work item

App storage

Stores your panel and template definitions on your site

The app never reads work items on its own behalf. Every Jira read runs as the person using the app, so existing project and issue-level permissions continue to apply unchanged.

Licensing

There is no licence key, activation step or trial code to enter. Once the app is installed it is ready to use.

Verifying the install

Two quick checks:

  1. Open any project, go to Project settings, and look under Apps for SmartLists for Jira. You should see the panel list with a Create Panel button.

  2. Open any work item in that project. The SmartLists for Jira panel should appear, with the message "No SmartLists applied yet. Please select a template to add a SmartList."

If the panel appears on the work item but nothing is offered in the Select panel dropdown, that is expected - no panels have been configured yet. Go to Configuring panels and columns.

Who configures what

SmartLists for Jira is a project-level app. Once a Jira administrator has installed it, project administrators take over: they create the panels, columns and templates for their own projects, without needing further help from a Jira admin.

Upgrading

Forge apps update automatically. There is no action to take when a new version ships.

Existing SmartList data is preserved across upgrades. One upgrade in the app's history renamed the issue property that holds SmartList rows; work items created before that change are migrated automatically the first time someone opens them. See Using SmartLists data elsewhere if you have scripts or automation rules that reference the old property name.

Uninstalling

Uninstall from Apps → Manage apps.

Uninstalling removes the app's panel and template definitions. SmartList rows are stored on the work items themselves as issue properties, so they are not part of the app's own storage - but they will no longer be visible anywhere in the Jira UI once the panel that renders them is gone.

If you may want the data later, export it first - see Import and export - or read the issue properties directly via the REST API as described in Using SmartLists data elsewhere.

Search