---
title: Admonitions
description: Admonitions allow you to highlight important information with varying levels of priority. In software documentation, these blocks are used to emphasize...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3809/syntax/admonitions
products:
  - Elastic Docs Builder
---

# Admonitions
Admonitions allow you to highlight important information with varying levels of priority. In software documentation, these blocks are used to emphasize risks, provide helpful advice, or share relevant but non-critical details.

## Basic admonitions

Admonitions can span multiple lines and support inline formatting.
<tab-set>
  <tab-item title="Output">
    <admonition title="Multiple paragraphs">
      Separate paragraphs with a blank line, just like regular Markdown.Adjacent lines without a blank line between them render as a single paragraph.
    </admonition>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{admonition} Multiple paragraphs
    Separate paragraphs with a blank line, just like regular Markdown.

    Adjacent lines without a blank line between them render as a single paragraph.
    :::
    ```
  </tab-item>
</tab-set>

Available admonition types include:
- [Note](#note)
- [Warning](#warning)
- [Tip](#tip)
- [Important](#important)
- [Plain](#plain)


### Note

A relevant piece of information with no serious repercussions if ignored.
<tab-set>
  <tab-item title="Output">
    <note>
      This is a note.It can span multiple lines and supports inline formatting.
    </note>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{note}
    This is a note.

    It can span multiple lines and supports inline formatting.
    :::
    ```
  </tab-item>
</tab-set>


### Warning

You could permanently lose data or leak sensitive information.
<tab-set>
  <tab-item title="Output">
    <warning>
      This is a warning.
    </warning>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{warning}
    This is a warning.
    :::
    ```
  </tab-item>
</tab-set>


### Tip

Advice to help users make better choices when using a feature.
You could permanently lose data or leak sensitive information.
<tab-set>
  <tab-item title="Output">
    <tip>
      This is a tip.
    </tip>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{tip}
    This is a tip.
    :::
    ```
  </tab-item>
</tab-set>


### Important

Ignoring this information could impact performance or the stability of your system.
<tab-set>
  <tab-item title="Output">
    <important>
      This is an important notice.
    </important>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{important}
    This is an important notice.
    :::
    ```
  </tab-item>
</tab-set>


### Plain

A plain admonition is a callout with no further styling. Useful to create a callout that does not quite fit the mold of the stylized admonitions.
<tab-set>
  <tab-item title="Output">
    <admonition title="This is my callout">
      This is a plain callout.It can *span* multiple lines and supports inline formatting.
    </admonition>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{admonition} This is my callout
    This is a plain callout.

    It can *span* multiple lines and supports inline formatting.
    :::
    ```
  </tab-item>
</tab-set>


## Applies to information

Admonitions support the `applies_to` property to indicate which products or versions the information applies to.
<tab-set>
  <tab-item title="Output">
    <note applies-to="Elastic Stack: Generally available since 9.1">
      This note applies to the Elastic Stack GA version 9.1.0.
    </note>

    <warning applies-to="Elastic Cloud Serverless: Generally available">
      This warning applies to serverless GA.
    </warning>

    <tip applies-to="Elastic Cloud Hosted: Generally available, Elastic Cloud Enterprise: Generally available">
      This tip applies to ECH and ECE.
    </tip>

    <important applies-to="Elastic Cloud Serverless: Generally available, Elastic Stack: Generally available since 9.2, Elastic Stack: Preview in 9.1">
      This important note applies to Elastic Stack GA version 9.2 and Elastic Stack Preview version 9.1. It also applies to serverless GA.
    </important>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{note}
    :applies_to: stack: ga 9.1.0

    This note applies to the Elastic Stack GA version 9.1.0.
    :::

    :::{warning}
    :applies_to: serverless: ga

    This warning applies to serverless GA.
    :::

    :::{tip}
    :applies_to: { ess:, ece: }

    This tip applies to ECH and ECE.
    :::

    :::{important}
    :applies_to: {"stack": "ga 9.2, preview 9.1", "serverless": "ga"}

    This important note applies to Elastic Stack GA version 9.2 and Elastic Stack Preview version 9.1. It also applies to serverless GA.
    :::
    ```
  </tab-item>
</tab-set>