Controlling marketplace behavior

The app is presented in the Iris Marketplace – from where apps can be deployed as extensions to the Manager.

The marketplace will be the gateway for new services to the industry provided by customers themselves, partners and 3rd party software developers – as well as Trackunit.

Installation policies

To control the behavior of your app inside the marketplace you have to specify an installation policy inside the Iris App manifest using the installation.policy attribute.

There are five distinct installation policies, with their behaviour described in the table below:

InstallationPolicyRequires approval from sales opsInitially installed (once approved if applicable)UninstallableVisible on MarketplaceDescription
PERMANENTnoyesnonoApps developed by Trackunit, needed by all customers
PREINSTALLEDnoyesyesnoApps developed by Trackunit or Partners that are part of the base subscription
ON_DEMANDnonoyesyesApps developed by Trackunit or Partners that are free to install
PREINSTALLED_REQUIRES_APPROVALyesyesyesyesApps developed by Trackunit that require extra pricing agreement
ON_DEMAND_REQUIRES_APPROVALyesnoyesyesApps developed by Partners that require extra pricing agreement

Most generally available apps should use a policy that requires explicit approval. Trackunit sales ops will make sure the customer has the right agreement before making the app available to the customer. This supports setting up rules for individually sold apps. Requirements such as pricing schemes should be agreed on with Trackunit before submitting the app for review.

Customer specific apps developed for one or few customers should include a list of customer account IDs in the installation.accountIds attribute and use the PREINSTALLED policy.
These apps will automatically be visible to the customers in the list.

Apps that are tied to a specific pricing plan should set the installation.pricingPlans attribute and can then choose to use either the ON_DEMAND or PREINSTALLED policies. Everyone with this pricing plan should get the app in the marketplace.

The PERMANENT installation policy should only be used with prior agreement with Trackunit, since they will be enabled for all customers and customers cannot uninstall the app. The app will not be visible in the marketplace. The only way to limit which customers get the app is using the installation.accountIds and/or installation.pricingPlans attributes.

Marketplace content


The marketplace overview will include the name and the description attributes from the app manifest. The description should be a short text without any formatting.
To show a logo you should put a image inside the assets folder in your Iris App and specify the name of the image in the logoPath attribute.

Detailed view

The detailed app view includes a longer description and a number of images and/or videos.

To add a longer description you should create a markdown file inside the assets folder and set the fullDescriptionPath attribute to the name of the file.

Any screenshots can also be added to the assets folder. They should all be listed in the assets array inside the manifest with their type set to IMAGE.

Videos of the app can also be added by uploading the video to Youtube or Vimeo and then adding a link to the video in the assets array inside the manifest. The video link should follow one of these formats for the Marketplace to pick it up as a video link:


Description markdown format

To format the longer description we support basic markdown syntax.

# The largest heading
With **bold** and *italic* text.
## The second largest heading
A a [link]( to somewhere.
###### The smallest heading
And a list
- Iris
- App

To test the markdown syntax this site can be used.


Example of marketplace content inside Iris App manifest:

marketplace: {
    name: "Trackunit Demo App",
    description: "This demo app is used for demoing stuff. It has one of each extension type.",
    fullDescriptionPath: "",
    logoPath: "logo.webp",
    assets: [
      { type: "IMAGE", path: "custom_fields.png" },
      { type: "IMAGE", path: "feature_demo.png" },
      { type: "IMAGE", path: "gql_demo.png" },
      { type: "VIDEO", url: "" },
    tags: []

We recommend studying the iris-app-manifest.ts file before building your app, as it will give you an understanding of the constraints within which your app can be built.