---
title: "Get Appearance Configuration"
method: GET
path: "/v2/portals/{portalId}/appearance"
tags: ["Portal Appearance"]
---

# Get Appearance Configuration

`GET /v2/portals/{portalId}/appearance`

Returns the current portal appearance configuration including any custom theme, colors, fonts, and image settings. Portals using the fully-customizable portal client may override or ignore these settings by disregarding them in the code.

## Path parameters

- `portalId` string, uuid, required

## Response `200`

Details about a portal's current appearance settings.

- V2GetPortalAppearanceResponse
  - `theme_name` 'mint_rocket' | 'dark_mode' | 'custom', required — Select a pre-existing default theme or specify 'custom' to use custom_theme variables.
  - `custom_theme` object, nullable, required — Groups of variables for configuring visual details of the portal user interface. Set theme_name to 'custom' to use custom values for theme variables.
    - `colors` V2AppearanceThemeColorVariables, required
      - `section` object, required
        - `header` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `body` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `hero` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `accent` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `tertiary` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `stroke` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `footer` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
      - `text` object, required
        - `header` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `hero` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `headings` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `primary` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `secondary` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `accent` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `link` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `footer` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
      - `button` object, required
        - `primary_fill` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
        - `primary_text` V2AppearanceColorVariable, required
          - `value` string, required
          - `description` string, nullable
  - `custom_fonts` object, nullable, required — Font selections to render text in the portal user interface. Must set use_custom_fonts to true to enable using custom font values.
    - `base` 'Roboto' | 'Inter' | 'Open Sans' | 'Lato' | 'Slabo 27px' | 'Slabo 13px' | 'Oswald' | 'Source Sans Pro' | 'Montserrat' | 'Raleway' | 'PT Sans' | 'Lora' | 'Roboto Mono' | 'Inconsolata' | 'Source Code Pro' | 'PT Mono' | 'Ubuntu Mono' | 'IBM Plex Mono', required — The name of the font to render in the browser.
    - `code` 'Roboto' | 'Inter' | 'Open Sans' | 'Lato' | 'Slabo 27px' | 'Slabo 13px' | 'Oswald' | 'Source Sans Pro' | 'Montserrat' | 'Raleway' | 'PT Sans' | 'Lora' | 'Roboto Mono' | 'Inconsolata' | 'Source Code Pro' | 'PT Mono' | 'Ubuntu Mono' | 'IBM Plex Mono', required — The name of the font to render in the browser.
    - `headings` 'Roboto' | 'Inter' | 'Open Sans' | 'Lato' | 'Slabo 27px' | 'Slabo 13px' | 'Oswald' | 'Source Sans Pro' | 'Montserrat' | 'Raleway' | 'PT Sans' | 'Lora' | 'Roboto Mono' | 'Inconsolata' | 'Source Code Pro' | 'PT Mono' | 'Ubuntu Mono' | 'IBM Plex Mono', required — The name of the font to render in the browser.
  - `use_custom_fonts` boolean, required — If true, fonts in custom_fonts will be used over the theme's default fonts
  - `text` object, nullable, required — Values to display for customizable text in the portal user interface
    - `catalog` object, required
      - `welcome_message` string, required
      - `primary_header` string, required
  - `images` object, nullable, required — A collection of binary image data to customize images in the portal
    - `logo` V2AppearanceImage, nullable — The image data to upload, along with an optional filename. Images must be a data URL with binary image data in base 64 format. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs.
      - `data` string, uri, required — must be a data URL with base64 image data, e.g., data:image/jpeg;base64,<BASE64_IMAGE_DATA>
      - `filename` string, nullable
    - `favicon` V2AppearanceImage, nullable — The image data to upload, along with an optional filename. Images must be a data URL with binary image data in base 64 format. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs.
      - `data` string, uri, required — must be a data URL with base64 image data, e.g., data:image/jpeg;base64,<BASE64_IMAGE_DATA>
      - `filename` string, nullable
    - `catalog_cover` V2AppearanceImage, nullable — The image data to upload, along with an optional filename. Images must be a data URL with binary image data in base 64 format. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs.
      - `data` string, uri, required — must be a data URL with base64 image data, e.g., data:image/jpeg;base64,<BASE64_IMAGE_DATA>
      - `filename` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/kong/apis/konnect-api.md) · [All operations](https://skmtc.net/kong/apis/konnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api/versions/06734a9c491f/schema)