---
title: "Update look and feel settings"
method: POST
path: "/wiki/rest/api/settings/lookandfeel/custom"
tags: ["Settings"]
---

# Update look and feel settings

`POST /wiki/rest/api/settings/lookandfeel/custom`

Updates the look and feel settings for the site or for a single space.
If custom settings exist, they are updated. If no custom settings exist,
then a set of custom settings is created.

Note, if a theme is selected for a space, the space look and feel settings
are provided by the theme and cannot be overridden.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'Admin' permission for the space.

## Query parameters

- `spaceKey` string

## Request body

- LookAndFeel
  - `headings` object, required
    - `color` string, required
  - `links` object, required
    - `color` string, required
  - `menus` MenusLookAndFeel, required
    - `hoverOrFocus` object, required
      - `backgroundColor` string, required
    - `color` string, required
  - `header` HeaderLookAndFeel, required
    - `backgroundColor` string, required
    - `button` ButtonLookAndFeel, nullable, required
      - `backgroundColor` string, required
      - `color` string, required
    - `primaryNavigation` NavigationLookAndFeel, nullable, required
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `secondaryNavigation` NavigationLookAndFeel, nullable, required
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `search` SearchFieldLookAndFeel, nullable, required
      - `backgroundColor` string, required
      - `color` string, required
  - `horizontalHeader` HorizontalHeaderLookAndFeel
    - `backgroundColor` string, required
    - `button` ButtonLookAndFeel, nullable
      - `backgroundColor` string, required
      - `color` string, required
    - `primaryNavigation` TopNavigationLookAndFeel, required
      - `color` string, nullable
      - `highlightColor` string, required
      - `hoverOrFocus` object
        - `backgroundColor` string
        - `color` string
    - `secondaryNavigation` NavigationLookAndFeel, nullable
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `search` SearchFieldLookAndFeel, nullable
      - `backgroundColor` string, required
      - `color` string, required
  - `content` ContentLookAndFeel, required
    - `screen` ScreenLookAndFeel
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable
      - `backgroundImage` string, nullable
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable
      - `layer` object, nullable
        - `width` string
        - `height` string
      - `gutterTop` string, nullable
      - `gutterRight` string, nullable
      - `gutterBottom` string, nullable
      - `gutterLeft` string, nullable
    - `container` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
    - `header` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
    - `body` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
  - `bordersAndDividers` object, required
    - `color` string, required
  - `spaceReference` object, nullable

## Response `200`

Returned if the look and feel settings are updated.

- LookAndFeelWithLinks — Look and feel settings returned after an update.
  - `headings` object, required
    - `color` string, required
  - `links` object, required
    - `color` string, required
  - `menus` MenusLookAndFeel, required
    - `hoverOrFocus` object, required
      - `backgroundColor` string, required
    - `color` string, required
  - `header` HeaderLookAndFeel, required
    - `backgroundColor` string, required
    - `button` ButtonLookAndFeel, nullable, required
      - `backgroundColor` string, required
      - `color` string, required
    - `primaryNavigation` NavigationLookAndFeel, nullable, required
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `secondaryNavigation` NavigationLookAndFeel, nullable, required
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `search` SearchFieldLookAndFeel, nullable, required
      - `backgroundColor` string, required
      - `color` string, required
  - `horizontalHeader` HorizontalHeaderLookAndFeel
    - `backgroundColor` string, required
    - `button` ButtonLookAndFeel, nullable
      - `backgroundColor` string, required
      - `color` string, required
    - `primaryNavigation` TopNavigationLookAndFeel, required
      - `color` string, nullable
      - `highlightColor` string, required
      - `hoverOrFocus` object
        - `backgroundColor` string
        - `color` string
    - `secondaryNavigation` NavigationLookAndFeel, nullable
      - `color` string, required
      - `highlightColor` string, nullable
      - `hoverOrFocus` object, required
        - `backgroundColor` string, required
        - `color` string, required
    - `search` SearchFieldLookAndFeel, nullable
      - `backgroundColor` string, required
      - `color` string, required
  - `content` ContentLookAndFeel, required
    - `screen` ScreenLookAndFeel
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable
      - `backgroundImage` string, nullable
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable
      - `layer` object, nullable
        - `width` string
        - `height` string
      - `gutterTop` string, nullable
      - `gutterRight` string, nullable
      - `gutterBottom` string, nullable
      - `gutterLeft` string, nullable
    - `container` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
    - `header` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
    - `body` ContainerLookAndFeel, nullable
      - `background` string, required
      - `backgroundAttachment` string, nullable
      - `backgroundBlendMode` string, nullable
      - `backgroundClip` string, nullable
      - `backgroundColor` string, nullable, required
      - `backgroundImage` string, nullable, required
      - `backgroundOrigin` string, nullable
      - `backgroundPosition` string, nullable
      - `backgroundRepeat` string, nullable
      - `backgroundSize` string, nullable, required
      - `padding` string, required
      - `borderRadius` string, required
  - `bordersAndDividers` object, required
    - `color` string, required
  - `spaceReference` object, nullable
  - `_links` GenericLinks

## Other responses

- `400` — Returned if; - The `spaceKey` is invalid - The request body contains invalid data.
- `403` — Returned if the calling user doesn't have permission to edit the look and feel settings.
- `404` — Returned if there is no space with the given `spaceKey`.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)