---
title: related-learning.yml
description: The related-learning.yml file is a global catalog of learning destinations (training modules, labs, and similar). Pages opt in with the {related-learning}...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3943/documentation/catalog/related-learning
products:
  - Elastic Docs Builder
---

# related-learning.yml
The [`related-learning.yml`](https://github.com/elastic/docs-builder/blob/main/config/related-learning.yml) file is a global catalog of learning destinations (training modules, labs, and similar). Pages opt in with the [`{related-learning}`](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3943/syntax/related-learning) directive by catalog ID.
This catalog ships with docs-builder and is available in both isolated and assembler builds. Content repositories pick up catalog changes on the next docs-builder version.

## Example

```yml
links:
  apm-with-elastic:
    title: APM with Elastic
    url: https://www.elastic.co/training/apm-with-elastic
  elastic-agent:
    title: Elastic Agent
    url: https://www.elastic.co/training/elastic-agent
```


## Structure

<definitions>
  <definition term="links">
    A YAML mapping where each key is a stable catalog ID (typically the training URL slug).
    - `title`: The link text shown on the page. Required.
    - `url`: An absolute `http` or `https` URL. Required.
  </definition>
</definitions>

Pages are not listed in this file. Authors place `{related-learning}` on the page and pass catalog IDs as the directive argument.

## Starter entries

The catalog currently includes these training modules:
- `apm-with-elastic`
- `elastic-agent`
- `index-basics`
- `data-types-and-mappings`

To add a module, add an entry in a docs-builder pull request. Then use its ID from `{related-learning}` in the content repository.