---
title: Add app settings and connection strings
slug: dxp/cms12-docs/add-app-settings-and-connection-strings
docTags: 
createdAt: 2026-06-01T17:39:49.858Z
---

Use these steps to access the app settings:

1. Log in to the PaaS portal with your credentials.
2. Select the project to manage.
3. Click on the **App Settings** tab on the project page.

Follow these steps to add or update an app setting or connection string:

1. Click **Add Secret** to add a setting, or click the **Edit** icon next to the existing setting. You can click the **Delete** icon to delete a setting.
2. Provide the following information:
   - **Name** – Enter a unique name for the setting. Secret names must be between 1 and 127 characters long, can only contain alphanumeric characters, and cannot start with *Episerver* or *Optimizely*.
   - **Environment** – Choose the environment for the setting. You can select from **Integration**, **Preproduction**, **Production**, or **ADE**.
   - **Type** – Select **AppSetting** or a type of connection string (such as SQLAzure) for the type of setting you want to add or update. You can use **Custom** for connection strings that do not match the predefined options, such as a connection string to Azure blob storage.
   - **Value** – Enter the value for the setting or connection string.
3. Click **Save** to store the setting.

The next deployment activates the added or updated setting to the selected environment. The setting is also available in the deployment slot during deployment.

:::hint{type="info"}
**Note**
Only deployments using Deployment API and using DXP Management Portal UI are supported.
App settings and connection strings values are not added/updated if you deploy with WebDeploy using \*.publishprofile file, FTP upload, or service principal.
:::

You can access secret values from web app code using `ConfigurationManager`, the same way as other values of `web.config` configurations.

Before deploying to Production, you should test your changes in the Integration and Preproduction environments to identify and resolve any potential issues before they impact your site.

:::hint{type="info"}
**Note**
If you have previously added a specific setting through support and then add one with the same name through PaaS portal, the next deployment overwrites the setting with the new value.
:::