## 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:

FieldDescriptionExample(s)Default value
Name (required)The display name for your custom integration. This can be any String.My Custom Integration
Integration IDThe _Integration ID_ is automatically generated based on the value entered in the _Name_ field.mycustomintegration
DescriptionOptional description to be displayed for the integration in the _Added integrations_ list.This is an example of a custom integration's description.
TypeThe type of integration. Currently there is only one supported type (document.field).document.fielddocument.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.10060
CSP PropertiesBecause 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.