# Setting: `avatar_custom_url`

- **Constant:** `ConfigInterface::AVATAR_CUSTOM_URL`
- **Category:** `security`
- **Type:** `text`
- **Required:** no
- **Sensitive:** no
- **Validation:** `nullable|string|max:2048`
- **Placeholder / default hint:** `https://example.com/avatar/{hash}`

## Description

Custom avatar URL template (only used when avatar provider is custom). Placeholders: {email}, {username}, {name}, {hash}, {app_url}

## Allowed options

_Free-form / no fixed options_

## Change via CLI

```bash
featherpanel saas getsetting avatar_custom_url
featherpanel saas setsetting avatar_custom_url "<value>"
```

## Change via API

```http
PATCH /api/admin/settings
Content-Type: application/json

{ "avatar_custom_url": "<value>" }
```