# Fonts

The font faces map styles render text with. Every command also takes the common flags — `--username`/`-u`, `--token`/`-t`, `--profile`, `--id` — described in [Shared parameters](https://docs.mapbox.com/cli/reference/#shared-parameters).

-   [`mapbox fonts list`](#mapbox-fonts-list)
-   [`mapbox fonts upload`](#mapbox-fonts-upload)
-   [`mapbox fonts delete`](#mapbox-fonts-delete)

## `mapbox fonts list`

Every font face an account owns.

**Parameters:**

| Parameter | Description |
| --- | --- |
| `--fresh` | Skip the cache. A face uploaded moments ago does not appear without it. |

**Examples:**

```sh
mapbox fonts list
mapbox fonts list -o json
```

## `mapbox fonts upload`

Upload a font face. Uploading the same face again replaces it.

**Parameters:**

| Parameter | Description |
| --- | --- |
| `--file` | The font file itself (`.ttf`, `.otf`, or similar), up to roughly 30 MB. Its bytes become the request body. |

**Examples:**

```sh
mapbox fonts upload --file "./Open Sans Regular.ttf"
```

## `mapbox fonts delete`

Delete a font face. Asks for confirmation at a terminal; `--yes` skips it.

**Parameters:**

| Parameter | Description |
| --- | --- |
| `<face>` | The full face name, family and style together — the spelling `fonts list` reports, such as `DIN Pro Regular` rather than `DIN Pro`. |

**Examples:**

```sh
mapbox fonts delete "Open Sans Regular"
```