# Custom Settings

### Overview <a href="#overview" id="overview"></a>

Custom theme settings are specified by the theme developer in the `artiva.config` file at the `custom` key, and there are five types of custom theme settings available:

* `select`
* `boolean`
* `color`
* `image`
* `text`

Once defined in the `artiva.config` file, custom settings can be accessed in themes using the `platform.custom` context`.`

### Setting keys/names <a href="#setting-keysnames" id="setting-keysnames"></a>

The key given to each setting is used as the display name in Artiva Admin, and as the property name on the `platform.custom` object.

### Setting groups <a href="#setting-groups" id="setting-groups"></a>

Custom theme settings are grouped into one of three categories in the Admin UI:

* Site-wide
* Homepage
* Post

By default, all custom settings appear in the **Site-wide** category. Custom settings that are specific to the homepage or post display are defined with an optional `"group"` property with the value `"homepage"` or `"post"`.