---
title: "Settings"
description: "Read and update the server-wide library pagination, search, and upload settings."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.recipery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

These are the install's shared settings — see the Library section in
[Profiles & Access](/features/profiles) for what they control. A
profile's own name, color, and password are edited through
[`PATCH /api/profiles/:id`](/api/profiles#patch-apiprofilesid), not here.

## `GET /api/settings`

Returns the current settings.

**Response**

```json
{
  "settings": {
"recipesPerPage": 50,
"searchResultLimit": 10,
"imageMaxSizeMb": 10
  }
}
```

## `PATCH /api/settings`

Updates one or more settings. All fields optional — only send what's
changing.

**Request body**

| Field | Type | Notes |
| --- | --- | --- |
| `recipesPerPage` | integer 10–500 | How many recipes the Library and Favorites grids show per page |
| `searchResultLimit` | integer 1–100 | How many results the search dialog shows before "keep typing to narrow it down" |
| `imageMaxSizeMb` | integer 1–100 | Largest photo accepted by uploads (hero image or step photo), in MB |

**Response:** `{ "settings": PublicAppSettings }`, or `400` if a field is
outside its allowed range.

Source: https://docs.recipery.dev/api/settings//index.md