---
title: "Setting a new title and description for the login page"
method: POST
path: "/v1/config/login-appearance"
tags: ["System Configuration"]
---

# Setting a new title and description for the login page

`POST /v1/config/login-appearance`

_(introduced: version 2026.1)_

An Administrator can use this endpoint to set a custom title and/or description to show to all users who visit the login page. The description will be shown as a subtitle. If a title or description is already set, the current configuration will be overwritten with the new one; the two configurations will not be merged.

## Response `200`

OK

- ConfigLoginAppearance
  - `key` string, required — The type of system configuration.
  - `setAt` string, required — ISO date format. The last time this system configuration was set.
  - `value` ConfigLoginAppearanceValue, required
    - `title` string — A custom title to show on the login page.
    - `description` string — A custom description to show on the login page as a subtitle.

## Changes

- **2026-04-03** `2aed27d9e013` — 1 info
  - endpoint added
- **2025-03-13** `e8c2858fd4eb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/config/login-appearance/post.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)