---
title: "Installation"
description: "Installation"
url: "https://www.contentstack.com/docs/developers/sdks/marketplace-sdk/javascript/reference/installation"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-09-06"
---

# Installation

## Installation

The installation class defined the installation related queries for the marketplace.

**Example:**

```
import * as contentstack from '@contentstack/marketplace-sdk'const client = contentstack.client({ authtoken: 'TOKEN'});client.marketplace('organization_uid').installation();
```

## fetch

The fetch method retrieves a specific installation of an app.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation('installation_uid').fetch()
.then((installation) => console.log(installation));
```

## update

The update installation call is used to update information of an installation.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

const updateInstallation = {
 name: 'APP_NAME',
 description: 'APP_DESCRIPTION',
 target_type: 'stack'/'organization',
};

const installation = client.marketplace('organization_uid').installation('installation_uid');
installation = Object.assign(installation, updateInstallation);
installation.update()
.then((installation) => console.log(installation));
```

Configuration that needs to be updated

Server configuration that needs to be updated

Webhooks attached to the app that needs to be updated

The location of the app in the UI flow that is to updated

## uninstall

The uninstall method uninstalls the installation.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation('installation_uid').uninstall()
.then((response) => console.log(response));
```

## configuration

The configuration method retrieves the organization level app installation configuration.

```
import * as contentstack from '@contentstack/marketplace-sdk' 
const client = contentstack.client({ authtoken: 'TOKEN'}); 
client.marketplace('organization_uid').installation('installation_uid').configuration() 
.then((response) => console.log(response));
```

## getConfigLocation

The getConfigLocation method retrieves the organization level app installation configuration.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'})

client.marketplace('organization_uid').installation('installation_uid').getConfigLocation()
.then((response) => console.log(response))
```

## setConfiguration

The setConfiguration method updates the organization level app installation configuration.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

client.marketplace('organization_uid').installation('installation_uid').setConfiguration()
.then((response) => console.log(response));
```

Configuration that needs to be updated

## serverConfig

The serverConfig method retrieves the server side organization level configuration required for the app.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation('installation_uid').serverConfig()
.then((response) => console.log(response));
```

## setServerConfig

The setServerConfig method updates the server side organization level configuration required for the app.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation('installation_uid').setServerConfig({<configuration_details>})
.then((response) => console.log(response));
```

Configuration that needs to be updated

## installationData

The installationData method retrieves the installation data of an app configuration.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation('installation_uid').installationData()
.then((response) => console.log(response));
```

## webhooks

The webhooks gives a Webhook instance.

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid')..installation('installation_uid').webhooks('webhook_uid');
```

The UID of webhook

## fetchAll

The fetchAll method retrieves all the installations in your Contentstack organization.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});
client.marketplace('organization_uid').installation().fetchAll({ < optional params object>})
.then((collection) => console.log(collection));
```

The App UIDs of which installation need to be listed

Installations UID of the app

Stack API key or organization UID

Field to sort the results (eg. created\_at, updated, at)

The order in which the response is given

Limit on API response to provide content in the list

Offset for skipping content in response

## getInstalledApps

The getInstalledApps method retrieves all the installed apps in your Contentstack organization.

```
Example 1:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

client.marketplace('organization_uid').installation().getInstalledApps()
.then((collection) => console.log(collection));Example 2:
If you have to retrieve the list of apps installed for a specific target UID, use the following code
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

client.marketplace('organization_uid').installation().getInstalledApps({

	target_uid: 'api_key', 

})

.then((collection) => console.log(collection));
```

To show only apps which have update

Specify whether your app is a stack app or an organization app

Stack API key or organization UID

Field to sort the results (eg. created\_at, updated, at)

The order in which the response is given

Limit on API response to provide content in the list

Offset for skipping content in response

## getInstalledUsers

The getInstalledUsers call retrieves the list of users for the organization who installed the apps.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

client.marketplace('organization_uid').installation().getInstalledUsers()
.then((collection) => console.log(collection));
```

## getInstalledStacks

The getInstalledStacks method retrieves the list of all the stacks a user is part of.

```
Example:
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'});

client.marketplace('organization_uid').installation().getInstalledStacks()
.then((collection) => console.log(collection));
```

The UID of installation

## Installation | JavaScript Marketplace SDK | Contentstack

Installation manages queries related to app installations within the Contentstack JavaScript Marketplace SDK.