---
title: Related learning
description: The {related-learning} directive adds a Related learning section that links to named destinations in the global catalog (training modules, labs, and similar)...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3943/syntax/related-learning
products:
  - Elastic Docs Builder
---

# Related learning
The `{related-learning}` directive adds a **Related learning** section that links to named destinations in the global catalog (training modules, labs, and similar). Titles and URLs live in [`related-learning.yml`](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3943/documentation/catalog/related-learning); the page only picks catalog IDs.
The heading is part of the directive, so it appears in **On this page**.

## Related learning

## Related learning
- [APM with Elastic](https://www.elastic.co/training/apm-with-elastic)


## Basic usage

List one or more catalog IDs as the directive argument. Display order matches the argument.
<tab-set>
  <tab-item title="Output">
    ## Related learning

    ## Related learning
    - [APM with Elastic](https://www.elastic.co/training/apm-with-elastic)
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{related-learning} apm-with-elastic
    :::
    ```
  </tab-item>
</tab-set>


## Multiple IDs

Separate IDs with commas. Order is the order of the list.
```markdown
:::{related-learning} index-basics, data-types-and-mappings
:::
```


## Custom heading

`:heading:` is optional. The default is `Related learning`. A custom heading also changes the **On this page** slug (the default heading uses the slug `related-learning-heading`).
```markdown
:::{related-learning} elastic-agent
:heading: Learn Elastic Agent
:::
```


## Argument and options

<definitions>
  <definition term="Argument">
    Required. Comma-separated catalog IDs. Unknown IDs fail the build. Duplicate IDs emit a warning and are skipped.
  </definition>
  <definition term=":heading:">
    Optional. Text for the section heading. Default: `Related learning`.
  </definition>
</definitions>

Links open in a new tab. Add new destinations in a docs-builder change to `related-learning.yml`; content repositories pick up new IDs on the next docs-builder version.