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

# Parse from YAML

> Converts YAML data into JSON.

Reads a piece of YAML text and turns it into structured data you can map field by field. Use this when a value arrives as a YAML document, such as a configuration block or a feed from a system that exports YAML, and you want to work with its keys and values as ordinary fields instead of one long string. Each YAML key becomes a field, and nested or list structures come through as nested data.

If the incoming text is in a character set other than UTF-8, you can turn on the encoding option to have it converted first.

This documentation describes: [Schema](/schemas/deserializer/yaml)

## Fields

**Input data is not UTF-8 encoded**

Optional

Turn this on when the incoming text is in a character set other than UTF-8, so accented and special characters come through correctly. It is off by default. Turning it on reveals the encoding and conversion options below.

**Input encoding**

Optional

The character set the incoming text is currently in. Choose from UTF-16, ISO-8859-1, or Windows-1252. Only shown when the encoding option above is on.

**On unconvertible characters**

Optional

How to handle characters that cannot be converted to UTF-8: leave it as NONE to fail on an unconvertible character, IGNORE to drop it, or TRANSLIT to replace it with the closest available character. Only shown when the encoding option is on.

## Sample data

This parser takes no settings of its own. It reads the YAML text and returns the structured data it describes.

Input:

```json theme={null}
{
    "payload": "id: 1001\ncustomer: Acme\ntotal: 49.95\n"
}
```

Output:

```json theme={null}
{
    "payload": {
        "id": 1001,
        "customer": "Acme",
        "total": 49.95
    }
}
```

Each YAML key becomes a field, and number-like values come back as numbers.

```json Configuration theme={null}
{
  "prototype": "yaml",
  "parameters": {}
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.