Callouts draw readers’ attention to tips, warnings and other important information. The Zendesk article editor now includes native callouts that you can add and edit straight from the toolbar, and our themes style them to match the rest of your help center. We recommend using them for all new content.
The class-based callouts used in earlier versions of our themes are still supported, so existing articles don’t need to change. You’ll find their instructions in the Legacy elements tab.
Native article components are supported in version 4.0.0 or later of our themes. If you’re using an earlier version, use the legacy elements instead.
Adding a callout
-
Create a new article or edit an existing one in your help center or Knowledge admin, and place your cursor where the callout should appear.
-
Click the Article components button in the editor toolbar and select Callout. The callout is added as an Info callout.
-
Type your message. Callouts can contain text, blockquotes, images, videos, tables and horizontal lines.
-
To change the style, click the Callout type field and select Info, Warning, Error or Tip.
-
Click Save.
To move a callout, hover over it and drag the handle. To remove one, click the handle to select the callout and press Delete.
Callout types
Each type has its own icon and color:
<div class="wysiwyg-callout wysiwyg-callout-info" role="note">
<span class="wysiwyg-callout-icon" aria-hidden="true"></span>
<p>Info callouts highlight helpful background information.</p>
</div>
<div class="wysiwyg-callout wysiwyg-callout-warning" role="note">
<span class="wysiwyg-callout-icon" aria-hidden="true"></span>
<p>Warning callouts draw attention to steps that need care.</p>
</div>
<div class="wysiwyg-callout wysiwyg-callout-error" role="note">
<span class="wysiwyg-callout-icon" aria-hidden="true"></span>
<p>Error callouts flag actions that can't be undone or will cause problems.</p>
</div>
<div class="wysiwyg-callout wysiwyg-callout-tip" role="note">
<span class="wysiwyg-callout-icon" aria-hidden="true"></span>
<p>Tip callouts suggest shortcuts and best practices.</p>
</div>The editor creates this markup for you, so you don’t need to use the editor’s HTML (source code) view. Use callouts sparingly: too many make each one less noticeable.
Styling callouts
The callout colors come from your theme’s info, warning, error and tip colors, and the padding, margin and corner radius are shared by all four types. You can change all of these in the Callouts section of the visual builder’s Formatting elements panel.
For more control, you can override Zendesk’s callout CSS variables in your theme’s stylesheet, scoped to the article content so they take precedence over the theme defaults. For example:
/* Use a stronger background for warning callouts */
.content .wysiwyg-callout-warning {
--zd-wysiwyg-callout-warning-bg: #fff1c2;
}
/* Use larger icons in all callouts */
.content .wysiwyg-callout {
--zd-wysiwyg-callout-icon-size: 1.25em;
}