---
title: "PUT /api/v4/application/appearance"
method: PUT
path: "/api/v4/application/appearance"
tags: ["instance"]
---

# PUT /api/v4/application/appearance

`PUT /api/v4/application/appearance`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/application/appearance`
- Auth: none declared

Modify appearance

## Request body `multipart/form-data`

- object
  - `title` string: Instance title on the sign in / sign up page
  - `description` string: Markdown text shown on the sign in / sign up page
  - `pwa_name` string: Name of the Progressive Web App
  - `pwa_short_name` string: Optional, short name for Progressive Web App
  - `pwa_description` string: An explanation of what the Progressive Web App does
  - `logo` string, binary: Instance image used on the sign in / sign up page
  - `pwa_icon` string, binary: Icon used for Progressive Web App
  - `header_logo` string, binary: Instance image used for the main navigation bar
  - `favicon` string, binary: Instance favicon in .ico/.png format
  - `member_guidelines` string: Markdown text shown on the members page of a group or project
  - `new_project_guidelines` string: Markdown text shown on the new project page
  - `profile_image_guidelines` string: Markdown text shown on the profile page below Public Avatar
  - `header_message` string: Message within the system header bar
  - `footer_message` string: Message within the system footer bar
  - `message_background_color` string: Background color for the system header / footer bar
  - `message_font_color` string: Font color for the system header / footer bar
  - `email_header_and_footer_enabled` boolean: Add header and footer to all outgoing emails if enabled
  - `site_name` string: Last part of the webpage title. Defaults to empty.

## Response `200`

Modify appearance

- APIEntitiesAppearance: API_Entities_Appearance model
  - `title` string, required
  - `description` string, required
  - `pwa_name` string, required
  - `pwa_short_name` string, required
  - `pwa_description` string, required
  - `logo` string, required
  - `pwa_icon` string, required
  - `header_logo` string, required
  - `favicon` string, required
  - `new_project_guidelines` string, required
  - `member_guidelines` string, required
  - `profile_image_guidelines` string, required
  - `header_message` string, required
  - `footer_message` string, required
  - `message_background_color` string, required
  - `message_font_color` string, required
  - `email_header_and_footer_enabled` boolean, required
  - `site_name` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)