---
title: "Configure and activate a custom app"
slug: "configure-and-activate-a-custom-app"
abstract: "How to configure and activate a custom Marketplace app."
---
# Configure and activate a custom app

After registering a custom app, you must configure and activate it.

To configure and activate a custom app:

1. In the [Cloud Portal](https://portal.sitecorecloud.io/), click **App studio** > **Studio**, then click the app you want to configure.
2. In the **Extension points** section, select at least one [area in the SitecoreAI user interface](https://doc.sitecore.com/mp/en/developers/marketplace/extension-points.html) where you want to display your app. You can change this selection any time as your app requirements change.
3. For every enabled extension point, review or, optionally, customize the **Route URL**. The [route URL](https://doc.sitecore.com/mp/en/developers/marketplace/organizing-your-app.html) represents a URL path in your application that the extension point is associated with.

    > [!important]
    > When you build your app using the Marketplace SDK in a later step, make sure to associate the same route URLs with a component of your app.

4. If you add more than one instance of the same extension point, review or, optionally, customize the **Display name**. The display name appears in the user interface as the extension point title.
5. In the **API access** section, select the APIs your app needs to access, if any. You can change this selection any time as your app requirements change.
6. In the **Permissions** section, enable pop-ups, clipboard access, and file downloads if your app requires them. You can change this selection any time as your app requirements change.
7. In the **Deployment URL** field, enter the localhost address where you'll develop your app. The deployment URL is the URL Sitecore uses to display your app. You'll change this to a production URL after development, when you finish configuration.

    Typical localhost address for React (Vite) apps: `http://localhost:5173`

    Typical localhost address for Next.js apps: `http://localhost:3000`

    > [!important]
    > If you [decided](https://doc.sitecore.com/mp/en/developers/marketplace/app-architecture-and-authorization-options.html "App architecture and authorization options") to use [custom authorization](https://doc.sitecore.com/mp/en/developers/marketplace/marketplace-glossary.html#UUID-cddb7f26-63be-0002-f1bd-1044187df5fe_mp-customauth "custom authorization"), set the deployment URL to the [custom DNS](https://doc.sitecore.com/mp/en/developers/marketplace/set-up-a-custom-dns-for-local-development.html "Set up a custom DNS for local development") you previously set up. For example, `https://myapp.local:3000`.
    >
    > When you build your app using the Marketplace SDK in a later step, make sure to start the app on the same address that you specify as the deployment URL.

8. In the **App logo** field, upload your app logo.

    If you don't have a logo yet, use a [temporary logo](https://media.sitecorecloud.io/api/media/v2/delivery/cf2c1403-5ee3-436e-0fa3-08de06908b4e/62a92a440c174dd9be5d9ae0393d9bad).

9. Make a note of your **Marketplace app ID**. You'll use this later, during development.
10. In the **Organizations** section, do not authorize other organizations to install your app yet. You do this after app development, when [finishing configuration](https://doc.sitecore.com/mp/en/developers/marketplace/finish-configuration.html).
11. If you [decided](https://doc.sitecore.com/mp/en/developers/marketplace/app-architecture-and-authorization-options.html) to use custom authorization[^UUID-cddb7f26-63be-0002-f1bd-1044187df5fe_mp-customauth], [create client credentials](https://doc.sitecore.com/mp/en/developers/marketplace/create-client-credentials.html) for your app.
12. Click **Activate** > **Activate**.

Next, [install](https://doc.sitecore.com/mp/en/developers/marketplace/install-an-activated-custom-app.html) the app.

[^UUID-cddb7f26-63be-0002-f1bd-1044187df5fe_mp-customauth]: Auth0 authorization flow for Marketplace applications that replaces the built-in authorization managed by the Marketplace SDK. Required if your app needs to make server-side API calls to SitecoreAI APIs.
