# Callouts

> Callouts

---


Callouts are Hugo shortcodes used to visually highlight supplementary, important, or high-risk information without disrupting the primary content flow.

## Plain

These are the main callout types that may be used to bring attention to a section of text. The callouts can be rendered in the center of the body or [on the side](#side).

### Basic

The most basic callout wraps a "box" around text.

``` go-html-template

This is a plain callout with no title. It has a [link](#plain-callouts) to a heading on this page. Its shortcode is `<call-out>`.

```

**Note:** 
This is a plain callout with no title. It has a [link](#plain-callouts) to a heading on this page.

### Custom title

A title can be added with the `title` parameter

``` go-html-template

This is a plain callout with title.

```

**Note:** 
This is a plain callout with title.

## Side

All callout types can also be rendered to the _side_ using the `sideline="true"` parameter.

``` go-html-template

This is a plain side callout with no title.

```

Naturally, callouts should contain less text within them than the text it lives next to. We do this for several reasons. Firstly, it looks weird to have a big empty space in the primary content area. Secondly, if you have more text in the callout, then it stops being a callout. I have asked an LLM to lengthen this passage.

**Note:** 
This is a plain side callout with no title.

## Important, but not urgent

This is a weird exception callout that adds just a little extra contrast to the callout.

``` go-html-template

This is an important callout.

```

**Note:** 
This is an important callout.

## Loud

These callouts should be used sparingly: only when it is imperative to capture the user’s attention.

### Warning

``` go-html-template

This is a warning callout.

```

**Note:** 
This is a warning callout.

### Caution

``` go-html-template

This is a caution callout.
This callout especially should be used VERY judiciously.

```

**Note:** 
This is a caution callout.
This callout especially should be used VERY judiciously.

### Custom titles

Loud callouts also accept custom titles.

``` go-html-template

This is a caution callout with a custom title.

```

**Note:** 
This is a caution callout with a custom title.

