> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-marketplace-apps.md).

# Work with Marketplace Apps

Install, configure, authorize, and disable marketplace apps from the Kizen App Marketplace, and set the permissions that control who can manage them.

{% hint style="success" %}
**Audience:** Administrators, developers, solution architects

**Purpose:** Explains how to work with marketplace apps in Kizen
{% endhint %}

## Overview

Marketplace apps appear in Kizen's App Marketplace under the Marketplace tab (see Figure 1). Any Kizen user with the necessary permissions can install any marketplace app for their business.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FsIS3nci52TcJn76VJmaE%2Fappdev_appmarketplace.png?alt=media&amp;token=6ce73d02-cb2b-40d4-ba19-4833a641341d" alt="The Marketplace tab of the App Marketplace displays all marketplace apps." width="563"><figcaption><p><strong>Figure 1:</strong> The Marketplace tab of the App Marketplace.</p></figcaption></figure></div>

For complete details on all our marketplace apps, see [Integrations](https://developer.kizen.com/docs/apps-and-integrations/integrations.md).

{% hint style="info" %}
**Note:** If you build an app that you intend to share with every business, you must submit your work to Kizen for approval before it appears in the App Marketplace. For more information, [contact us](https://support.kizen.com/support/tickets/new).
{% endhint %}

This topic covers the following tasks:

* [Set permissions for marketplace apps](#set-permissions-for-marketplace-apps)
* [Install a marketplace app](#install-a-marketplace-app)
* [Review your installed marketplace apps](#review-your-installed-marketplace-apps)
* [Inspect the details of an installed marketplace app](#inspect-the-details-of-an-installed-marketplace-app)
* [Configure an installed marketplace app](#configure-an-installed-marketplace-app)
* [Authorize an installed marketplace app](#authorize-an-installed-marketplace-app)
* [Disable an installed marketplace app](#disable-an-installed-marketplace-app)
* [Re-enable a disabled marketplace app](#re-enable-a-disabled-marketplace-app)

***

## Set permissions for marketplace apps

The permissions for marketplace apps appear under the App Platform section of the permissions settings (see Figure 2).

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Frt9t4e1ulC71ITpHzNVA%2Fappdev_marketplaceapps_permissions.png?alt=media&amp;token=3e735e19-30b2-42f4-92b6-1fff2149e34b" alt="The user finds the permission controls for marketplace apps in the App Platform settings." width="563"><figcaption><p><strong>Figure 2:</strong> Permissions for marketplace apps. </p></figcaption></figure></div>

To control access to marketplace apps, set the Marketplace App Advanced Configuration and Manage Marketplace Apps permissions. See the following table for details.

<table><thead><tr><th valign="top">Permission</th><th valign="top">Controls access to</th><th valign="top">None</th><th valign="top">View</th><th valign="top">Create/Edit</th><th valign="top">Delete/All</th></tr></thead><tbody><tr><td valign="top">Marketplace App Advanced Configuration</td><td valign="top">Raw JSON configuration data for apps without a setup assistant</td><td valign="top">The user can't access this configuration data.</td><td valign="top"><em>There are no   separate permissions at the View level.</em></td><td valign="top">The user can access and edit this configuration data.</td><td valign="top"><em>There are no separate permissions at the Delete/All level.</em></td></tr><tr><td valign="top">Manage Marketplace Apps</td><td valign="top">Marketplace apps</td><td valign="top">The user can't view or install marketplace apps but can perform user-level authorization through a direct link to the app's configuration page.</td><td valign="top">The user can view and install marketplace apps but can't configure business-level settings.</td><td valign="top"><em>There are no separate permissions at the Create/Edit level.</em></td><td valign="top">The user can enable and disable marketplace apps, authorize business-level features, inspect authorized users, and perform upgrades.</td></tr></tbody></table>

For more information on permissions in Kizen, see [Permissions](https://developer.kizen.com/docs/settings-and-administration/permissions.md).&#x20;

***

## Install a marketplace app

To install a marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Find the app to install

Use the Search Marketplace field to find the app's card in the App Marketplace, or browse the apps one page at a time.
{% endstep %}

{% step %}

### Turn on the app

Select the switch on the app's card.
{% endstep %}

{% step %}

### Configure the app as needed

If the app requires configuration before you can use it, a setup assistant guides you through the process. Follow the onscreen prompts.

{% hint style="info" %}
**Note:** You can reconfigure the app at any time. For details, see [Configure an installed marketplace app](#configure-an-installed-marketplace-app) below.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Review your installed marketplace apps

To review your installed marketplace apps:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab&#x20;

Kizen displays a complete list of every marketplace app you have installed for your business, including apps that you installed and then disabled.

This list also includes installed business apps. For more information, see [Work with Business Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-business-apps.md).

{% hint style="info" %}
**Note:** If an app requires attention, Kizen displays a caution icon to the right of its status. Hover over the icon with the mouse pointer for more information. You can also select the icon to open the app's configuration page and go directly to the issue to resolve.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Inspect the details of an installed marketplace app

To inspect the details of an installed marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business.
{% endstep %}

{% step %}

### Open the app details

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and select **View Details**.

The details appear under the App Details tab of the app's configuration page.

{% hint style="info" %}
**Note:** To get the current version number of the app, switch to the Version tab of the app's configuration page. You can also find this information in the list of installed marketplace apps.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Configure an installed marketplace app

To configure an installed marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business.
{% endstep %}

{% step %}

### Open the app's configuration page

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and choose **View Details**.
  {% endstep %}

{% step %}

### Configure the app

Do either of the following:

* **To configure the app settings for all users in your business,** switch to the App Settings tab.
* **To configure the app settings for your individual Kizen account,** switch to the User Settings tab.

{% hint style="info" %}
**Note:** If you don't find the App Settings or User Settings tab on the marketplace app's configuration page, the app doesn't have these settings to configure.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Authorize an installed marketplace app

Some apps require authorization before use. To authorize an installed marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business.
{% endstep %}

{% step %}

### Open the app's configurtaion page

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and choose **View Details**.
  {% endstep %}

{% step %}

### Authorize the app

To authorize the app:

1. Switch to the Authorization tab.
2. Select **Authorize App**.
3. Follow the onscreen prompts.
   {% endstep %}
   {% endstepper %}

***

## Disable an installed marketplace app

To disable an installed marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business.
{% endstep %}

{% step %}

### Disable the app

Open the app's Actions menu, and select **Disable**.

{% hint style="info" %}
**Note:** You can't disable certain marketplace apps.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Re-enable a disabled marketplace app

To re-enable a disabled marketplace app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business, including the ones you have disabled.
{% endstep %}

{% step %}

### Re-enable the app

Open the app's Actions menu, and select **Enable**.
{% endstep %}
{% endstepper %}

***

## What's next

Continue to [Work with Business Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-business-apps.md) for step-by-step procedures on managing business apps in Kizen.

<details>

<summary>Related Topics</summary>

* [Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development.md)
* [Work with Business Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-business-apps.md)
* [Develop Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/develop-apps.md)
* [Integrations](https://developer.kizen.com/docs/apps-and-integrations/integrations.md)

</details>

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-marketplace-apps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
