## Create a custom SAML application

This guide outlines the steps to create and configure a custom SAML application.

### Step 1: Upload Identity Provider metadata

#### Automatic configuration

1. Copy the values from the form below into your IdP. For more detailed instructions, refer to the documentation provided by your Identity Provider.


![custom](/assets/custom-1.c12f226581ff5a4013e92fa230b585a9a3eaa73bbd47712a67b04b9c07fdcf6c.dba07de7.png)

1. Locate the **Metadata URL** of the SAML application and paste it under the **IdP Metadata URL**.


![custom](/assets/custom-2.5644e968dba8f846380cef85fe3574974eb0e07f63ff8e5e18bb45d41f972571.dba07de7.png)

#### Manual configuration

1. Fill the form below for manual SAML configuration. For more detailed instructions, refer to the documentation provided by your Identity Provider.


![custom](/assets/custom-3.9ab0c294b124db3852dc7bd289c490f2abf0db995dc71c3fcfa3324f22fabd78.dba07de7.png)

### Step 2: Proceed with domain claiming and role assignment

1. Click on **Proceed with domain claiming and role assignment** to confirm the completion the configuration of the IDP form.
2. Follow the instructions in the [Self-service SAML configuration](/ciam/guides/authentication/sso/self-service/saml#claim-domain) guide to complete this step and manage authorization.