---
updatedAt: 2026-04-20T19:22:48.000Z
---

# Add custom CSS stylesheets

[block:html]
{
  "html": "<div>\n<video width=\"600\" height=\"400\" controls poster=\"https://techdocs.akamai.com/identity-cloud/videos/posters/screen-customization.png\">\n  <source src=\" https://techdocs.akamai.com/identity-cloud/videos/screen-customization-video.mp4\" type=\"video/mp4\">\n  <strong>Error</strong>: The video's URL was inaccessible.\n</video>\n<p><strong>Screen Customization</strong></p>\n</div>"
}
[/block]

<br>

You can use CSS to modify the look and feel of the Hosted Login screens; you do this by creating a supplementary stylesheet of your own (one that uses the same styles called out in Hosted Login’s default stylesheet) and then completing the following process:

1. Place your new CSS stylesheet on a publicly-available website.

2. Add the **theming.stylesheetURLs** setting to your Hosted Login application client. This can be done either by using the Identity Cloud Console or by using the Identity Cloud’s Configuration APIs.

3. Set the value of **theming.stylesheetURLs** to the URL of the your default CSS stylesheet followed by the URL of the new stylesheet, separating the URLs by using commas. If you want, you can add even *more* custom stylesheets; just be sure you separate the stylesheet URLs by using commas.

To better explain the process, let's first take a peek at a stylesheet that updates several of the default styles (in this case, styles used on the sign-in screen):

[block:code]
{
  "codes": [
    {
      "code": "screen-heading {\n margin-top:0;\n font-size:28px;\n text-align:center;\n width:520px\n}\n\n.screen-description {\n margin-top:0;\n font-size: 18px;\n width:520px;\n text-align:center;\n margin-bottom:30px\n}\n\n.additional-actions-container {\n text-align:center;\n background-color: peachpuff\n}\n\n.sign-in-button {\n background-color:orange;\n border-color:orange;\n color:black;\n font-size:18px\n}\n\n.footer-container {\n border-top: none;\n background-color:peachpuff\n}\n\na.aic-control {\n text-decoration:none;\n}\n\n.cancel-link {\n display: block;\n text-decoration:none\n}\n\n.traditional-signin {\n position:relative;\n margin-top:30px;\n width:520px;\n font-size: 18px\n}\n\n.forgot-password-link {\n position: absolute;\n right: 8px;\n bottom:0;\n color:blue;\n font-size:18px;\n text-decoration:none\n}\n\n.social-signin {\n width:560px\n}\n\n.alternate-credentials {\n font-size:18px;\n margin-bottom:50px;\n text-align:center\n}",
      "language": "css"
    }
  ]
}
[/block]

If this stylesheet is publicly-accessible, and if the stylesheet is loaded after the default Hosted Login stylesheet, then the styles shown above should override the default styles. For example, by default the **Sign In** button is blue:

<p style="align:left"><img src="https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/sign-in-button-theming.png" width="100"></p>

However, the custom CSS sets the color of that button to orange:

[block:code]
{
  "codes": [
    {
      "code": ".sign-in-button {\n background-color:orange;\n border-color:orange;\n color:black;\n font-size:18px\n}",
      "language": "css"
    }
  ]
}
[/block]

So what color will the sign-in button be when the sign-in screen is displayed? We’ll find out in a minute. First, however, we need to talk a little bit about custom stylesheets and Hosted Login.

<br>

# A few notes about custom stylesheets

As mentioned earlier, it’s important that you include the default stylesheet when configuring the **theming.stylesheetURLs** setting. As you might expect, the default stylesheet contains style settings for the items that can appear on a Hosted Login screen. Among other things, that means that, if the default stylesheet isn’t specified in the **theming.stylesheetURLs**, then any items not included in your custom stylesheet won’t have a CSS style. In turn, that means you’ll get some … interesting … results when Hosted Login tries to render your screens:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/no-default-css-theming.png)

The point we're trying to make should be obvious from the preceding screenshot: make sure you include the default stylesheet in the **theming.stylesheetURLs** setting. 

<br>

[block:callout]
{
  "type": "info",
  "body": "So what *is* your default stylesheet? That’s a good question, and the answer will vary depending on which version of Hosted Login you’re using. The best way to verify the stylesheets being loaded by Hosted Login is to go to your sign-in screen and then view the page source:\n\n![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/default-css-theming.png)"
}
[/block]

<br>

It’s also important that your custom stylesheet be listed *after* the default stylesheet. For example:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/create-css-theming.png)

Does it really matter which stylesheet is listed first? As it turns out, yes, it does. When stylesheets are applied In Hosted Login, they’re applied in the order shown in the **theming.stylesheetURLs** setting. For example, suppose we have a hypothetical stylesheet that sets squares to blue and circles to red:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/blue-red-theming.png)

We then load a custom stylesheet that sets squares to green:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/green-theming.png)

When our screen renders, we’ll see this:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/green-red-theming.png)

That’s because we had a conflict between the two stylesheets: Stylesheet 1 set squares to blue and Stylesheet 2 set squares to green. Because Stylesheet 2 was the most-recently loaded stylesheet, it wins, and squares are green.

<br>

[block:callout]
{
  "type": "info",
  "body": "Why are circles red? Because there was no conflict. As a result, circles were initially set to red, then never changed. A second stylesheet adds new styles not defined in the first stylesheet, or replaces conflicting styles. But it doesn’t remove styles defined in Stylesheet 1 that aren’t mentioned in Stylesheet 2."
}
[/block]

<br>

Now, suppose we switch the load order of the stylesheets. In that case, the green square is applied, but it then gets overridden by the blue square. As a result, we see this:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/blue-red-theming.png)

Which is not what we were hoping to see.

Incidentally, if you manage to get yourself into a situation where nothing is rendering correctly, just remove the **theming.stylesheetURLs** setting altogether. If this setting can’t be found then Hosted Login reverts to using the default stylesheet. If nothing else, at that point you’ll be able to start over again.

And here’s something else to keep in mind: if a custom font type is specified in one of your stylesheets, that font must also be included in the **theming.fontURLs** setting. If it isn't, you'll get a CSP (Content Security Policy) error in the browser console and the font won't load.

<br>

# Use Console to add a custom CSS stylesheet

To use Console to add a custom stylesheet to an application client, complete the following procedure:

1. In Console, click **Manage Properties** and then click the name of your application client:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/pick-client-theming.png)

2. On the **Edit** page, click **Edit Settings**:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/edit-settings-theming.png)

3. On the **Edit Settings** page, click the **Add Setting** icon:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/add-setting-theming.png)

4. In the field for the new setting, type **theming.stylesheetURLs** and then click **Create theming.stylesheetURLs**:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/create-css-2-theming.png)

5. In the **Value** field for the **theming.stylesheetURLs** setting, enter the URL to your default stylesheet. You can then add additional stylesheets, separating the individual sheets by using commas. For example:

   ```
   https://v1.api.us.janrain.com/auth-ui/static/base.css,
   https://dyzz9obi78pm5.cloudfront.net/app/image/id/5e5937aa8e121c00498350af/n/test.css
   ```

   Your new setting should look similar to this:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/1602187873592.png)

6. Click **Save Settings** to save your changes:

   ![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/save-setting-theming.png)

<br>

# Use the Configuration APIs to add a custom CSS stylesheet

To a custom stylesheet by using the Configuration APIs, start by calling the [/config/{appId}/clients/{apiClientId}/settings](https://techdocs.akamai.com/identity-cloud-config/reference/get-client-settings) operation and the GET method to return the current properties and property values of your application client. For example, if your application client has the client ID hrhtj4p8dz9wqhwtpuvg2k8ndet748vs, a Curl command to return the current properties and property values will look similar to this:

[block:code]
{
  "codes": [
    {
      "code": "curl -L -X GET \\\n 'https://v1.api.us.janrain.com/config/79y4mqf2rt3bxs378kw5479xdu/clients/hrhtj4p8dz9wqhwtpuvg2k8ndet748vs/settings' \\\n-H 'Authorization: Basic 6rhfZmc2ZjQ0bXNhYzN2ZXBqanZ4Z2d6dnQzZTNXNhY6OTVjY3hrN2N6YnZ1eng2ZHB0ZTVrpo9uZGo1Ynpxt5U=='",
      "language": "curl"
    }
  ]
}
[/block]

In turn, your API response will look similar to the following (with the obvious caveat that the properties and property values you get back will depend on how your application client is configured):

[block:code]
{
  "codes": [
    {
      "code": "{\n \"user\\_entity_type\": \"GREG\\_DEMO\",\n \"_self\": \"/config/79y4mqf2rt3bxs378kw5479xdu/clients/hrhtj4p8dz9wqhwtpuvg2k8ndet748vs/settings\",\n \"default_flow_version\": \"HEAD\",\n \"default_flow_name\": \"videos\",\n \"regex_standard_newPassword\": \".*\",\n \"janrainOidcClientId\": \"70a45721-c6ef-4d7c-91ff-f14e9346b8b6\",\n \"verify_email_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/verify-account?client\\_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\",\n \"site_name\": \"Test Public Client\",\n \"password_recover_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/reset-password?client_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\"\n}",
      "language": "json"
    }
  ]
}
[/block]

After you have the API response:

1. Copy the entire response.

2. Create a new API call, one that uses the [/config/{appId}/clients/{client_id}](https://techdocs.akamai.com/identity-cloud-config/reference/put-client-settings) operation and the PUT method.

3. Paste the copied API response (still in JSON format) into the request body of the new API call.

For example, if you’re using Postman your screen will look similar to this:

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/body-parameter-theming.png)

In the **custom** property of the request body, add the **theming.stylesheetURLs** setting, configuring the value of the new property to the URL of the default stylesheet and the URL of the stylesheet being added to Host Login. For example: 

[block:code]
{
  "codes": [
    {
      "code": "\"custom\": {\"theming.stylesheetURLs\": \"https://v1.api.us.janrain.com/auth-ui/static/base.css,\nhttps://dyzz9obi78pm5.cloudfront.net/app/image/id/5e5937aa8e121c00498350af/n/test.css\"},",
      "language": "text"
    }
  ]
}
[/block]

<br>

[block:callout]
{
  "type": "info",
  "body": "If your request body doesn’t have a **custom** property you’ll need to add one and then configure the **theming.stylesheetURLs** setting inside the new **custom** property."
}
[/block]

<br>

Your request body should look like this:

[block:code]
{
  "codes": [
    {
      "code": "{\n \"user_entity_type\": \"GREG\\_DEMO\",\n \"_self\": \"/config/79y4mqf2rt3bxs378kw5479xdu/clients/hrhtj4p8dz9wqhwtpuvg2k8ndet748vs/settings\",\n \"default_flow_version\": \"HEAD\",\n \"default_flow_name\": \"videos\",\n \"custom\": {\"theming.stylesheetURLs\": \"https://v1.api.us.janrain.com/auth-ui/static/base.css,https://dyzz9obi78pm5.cloudfront.net/app/image/id/5e5937aa8e121c00498350af/n/test.css\"},\n \"verify_email_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/verify-account?client_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\",\n \"site_name\": \"Test Public Client\",\n \"password_recover_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/reset-password?client_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\"\n}",
      "language": "json"
    }
  ]
}
[/block]

In turn, your Curl command should look like this:

[block:code]
{
  "codes": [
    {
      "code": "curl -L -X PUT 'https://v1.api.us.janrain.com/config/79y4mqf2rt3bxs378kw5479xdu/clients/hrhtj4p8dz9wqhwtpuvg2k8ndet748vs/settings' \\\n-H 'Authorization: Basic 6rhfZmc2ZjQ0bXNhYzN2ZXBqanZ4Z2d6dnQzZTNXNhY6OTVjY3hrN2N6YnZ1eng2ZHB0ZTVrpo9uZGo1Ynpxt5U==' \\\n-H 'Content-Type: application/json' \\\n--data-raw '{\n \"user_entity_type\": \"GREG\\_DEMO\",\n \"_self\": \"/config/79y4mqf2rt3bxs378kw5479xdu/clients/hrhtj4p8dz9wqhwtpuvg2k8ndet748vs/settings\",\n \"default_flow_version\": \"HEAD\",\n \"default_flow_name\": \"videos\",\n \"custom\": {\"theming.stylesheetURLs\": \"https://v1.api.us.janrain.com/auth-ui/static/base.css**,**https://dyzz9obi78pm5.cloudfront.net/app/image/id/5e5937aa8e121c00498350af/n/test.css\"},\n \"verify_email_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/verify-account?client_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\",\n \"site_name\": \"Test Public Client\",\n \"password_recover_url\": \"https://v1.api.us.janrain.com/e0a70b4f-1eef-4856-bcdb-f050fee66aae/auth-ui/reset-password?client_id=70a45721-c6ef-4d7c-91ff-f14e9346b8b6\"\n}\n'",
      "language": "curl"
    }
  ]
}
[/block]

Now make your API call. If all goes well, you’ll get back both a **200 OK**HTTP status code and a response that includes the new set of property values assigned to the application client.

<br>

[block:callout]
{
  "type": "info",
  "body": "Why do you have to copy *all* the property values and include all those values in your API call? That’s because the PUT method is all-or-nothing: it replaces *all* the settings currently assigned to the application client with the settings you have explicitly specified in your API call. Suppose your application client includes the **default\\_flow\\_name** and **default\\_flow\\_version** settings, but you forget to include those in your API call. When you make your call, those two settings will be deleted from the application client."
}
[/block]

<br>

# Verify your stylesheet

To verify that Hosted Login is using your custom stylesheet, wait a minute or two for your changes to take effect, then access your Hosted Login sign-in screen. If your new styles are used on the sign-in screen, you should see those new styles in action (for example, note the color of the **Sign In** button):

![](https://techdocs.akamai.com/identity-cloud/img/oidc/user-experience/configuration/custom-css-theming.png)

If those styles aren’t used on the sign-in screen you’ll have to click around a bit until you come across a screen where those new styles *are* employed.

# Sibling pages

* [Change your logo](https://techdocs.akamai.com/identity-cloud/docs/change-your-logo.md)
* [Change your favicon](https://techdocs.akamai.com/identity-cloud/docs/change-your-favicon.md)
* [JavaScript Injection](https://techdocs.akamai.com/identity-cloud/docs/javascript-injection.md)
* [Add fonts](https://techdocs.akamai.com/identity-cloud/docs/add-fonts.md)
* [Modify screen text](https://techdocs.akamai.com/identity-cloud/docs/modify-screen-text.md)
* [Localize screen text](https://techdocs.akamai.com/identity-cloud/docs/localize-screen-text.md)
* [Add a custom link to a Hosted Login screen](https://techdocs.akamai.com/identity-cloud/docs/add-a-custom-link-to-a-hosted-login-screen.md)
* [Use plurals or objects in custom claims](https://techdocs.akamai.com/identity-cloud/docs/user-plurals-or-objects-in-custom-claims.md)