## Introduction
### Goal
Configure a custom integration in your Content SaaS environment.
### Background
It is possible to [integrate your apps](🔗) in the UI of Content SaaS using predefined extension points. This page explains how to add and configure your custom integration.
Bloomreach Content Marketplace
Bloomreach provides a repository of example and out-of-the-box integrations at the [Bloomreach Content Marketplace](🔗) at [marketplace.bloomreach.works](🔗).
## Manage Integrations
In the left navigation, select _Setup_, then _Integrations_. You will see the following screen:
If you have previously added any integrations, they are listed under _Added integrations_. Click on an added integration to modify its configuration.
Click on _Custom integration_ under _Available integrations_ to add a new custom integration.
## Configuration
A custom integration is configured through a form:
The form contains the following fields:
| Field | Description | Example(s) | Default value |
| Name (required) | The display name for your custom integration. This can be any String. | My Custom Integration | |
| Integration ID | The _Integration ID_ is automatically generated based on the value entered in the _Name_ field. | mycustomintegration | |
| Description | Optional description to be displayed for the integration in the _Added integrations_ list. | This is an example of a custom integration's description. | |
| Type | The type of integration. Currently there is only one supported type (document.field). | document.field | document.field |
| Configuration (required) | A JSON object containing any configuration parameters for your integration.
_Configuration_ is a required field but accepts an empty object (`{}`). | `{ "foo": "bar" }`
`{}` | |
| Application URL (required) | The URL at which your custom integration is accessible. | ht<span>tps://example.com/mycustomintegration | |
| Height (px) | The height in pixels of the iframe in which the custom integration is rendered. | 100 | 60 |
| CSP Properties | Because custom integrations run on an external host and are displayed in an iframe in the UI, you must add the relevant domain(s) to the [Content Security Policy](🔗) of your Content SaaS environment. Select the relevant _CSP Property_ in the dropdown and enter the domain in the text field next to the dropdown. You can add additional CSP properties using the _+_ button. Any changes to an integration's CSP properties will only take effect after refreshing the browser or logging out and back in. | frame-src: http://example.com or https://example.com | |
Once you have entered all the relevant configurations, click on _Add_ (when adding a new custom integration) or _Save_ (when modifying an already added integration) to persist your changes.
Any changes to an integration's CSP properties will only take effect after refreshing the browser or logging out and back in.