Developer Programs

Learn

Docs

Callout

Formatting your Content > Shortcodes > Callout
shortcode
shortcode
content
content

Callouts are used to call the user’s attention to a block of information that they really need to see. A callout displays its content with eye-catching formatting.

Use the jhdocs-callout shortcode to display a callout.

This shortcode takes the following parameters:

  • type: The type of styling to display. One of neutral, tip, do, dont, warning, info
  • icon: Icon to display. Use a value from the icons page or leave this blank to have it set based on the specified type.
  • title: Callout title. String that specifies the title to display. Leave blank for no title.

Simple example

This first callout example is a simple one. It sets the type and title to “tip”, and provides content. The callout color and icon are all based on the specified type, which is “tip” in this case.

Simple callout example markdown
{{< jhdocs-callout type="tip" title="Tip" >}}
It's best to save your work often.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Tip
It’s best to save your work often.

More complex example

The next example is a little more complicated… it sets the type to “warning”, the icon to “camera”, and doesn’t specify a title.

More complex callout example markdown
{{< jhdocs-callout type="warning" icon="camera" >}}
Don't forget to remove the lens cap before snapping that pic.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Don’t forget to remove the lens cap before snapping that pic.

“Neutral” styling example

'Neutral' styling example markdown
{{< jhdocs-callout type="neutral" title="Checkpoint" >}}
Be sure to read the [Hugo documentation](https://gohugo.io/) before proceeding.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Checkpoint
Be sure to read the Hugo documentation before proceeding.

“Tip” styling example

'Tip' styling example markdown
{{< jhdocs-callout type="tip" title="Tip" >}}
Buy low, sell high.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Tip
Buy low, sell high.

“Info” styling example

'Info' styling example markdown
{{< jhdocs-callout type="info" title="Did you know?" >}}
A crocodile cannot stick its tongue out.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Did you know?
A crocodile cannot stick its tongue out.

“Warning” styling example

'Warning' styling example markdown
{{< jhdocs-callout type="warning" title="Warning" >}}
Memento mori.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Warning
Memento mori.

“Do” styling example

'Do' styling example markdown
{{< jhdocs-callout type="do" title="Do" >}}
Brush your teeth after every meal.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Do
Brush your teeth after every meal.

“Don’t” styling example

'Don't' styling example markdown
{{< jhdocs-callout type="dont" title="Don’t" >}}
Don't poke a skunk.
{{< /jhdocs-callout >}}

Here is the rendered result of this markdown:

Don't
Don’t poke a skunk.
Next topic: Caption

Support options
Have questions on this topic?
Join the jhDocs team in Microsoft Teams to connect with the community.
See something in this page that needs to change?
Send us feedback on this page.

Did this page help you?

Last updated Wed Dec 17 2025