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

# schema

> The configuration version. Always 1 in the current gaal release.

```yaml theme={"theme":"nord"}
schema: 1
```

## Type

`integer`

## Required

Recommended. If omitted, gaal assumes `schema: 1` and prints a deprecation warning. A future release may require it.

## Allowed values

| Value | Status                                                                                                     |
| ----- | ---------------------------------------------------------------------------------------------------------- |
| `1`   | The current and stable schema. All gaal features documented on this site read and write `schema: 1` files. |

## Stability guarantee

`schema: 1` is stable forever. Future gaal releases will continue to read it. When a breaking change is necessary, gaal will introduce `schema: 2` with a documented migration path. Existing `schema: 1` files will not be silently broken.

## Why it's at the top

Putting `schema:` at the top makes the file self-describing. A tool reading `gaal.yaml` (your editor, a linter, a CI check) can branch on the value before parsing the rest.

## Related

<CardGroup cols={2}>
  <Card title="Schema overview" icon="book" href="/schema/overview" />

  <Card title="The gaal.yaml file" icon="file-code" href="/concepts/gaal-yaml" />
</CardGroup>