Adding custom blocks

Our themes allow you to present custom, configurable blocks on the Home page which you can use to link to important pages or external resources.

On this page

They come in a variety of shapes and sizes and, like everything else in our themes, can be easily customized to your specific requirements.

Custom blocks are similar to the content blocks and contact blocks which present categories or sections and contact options, respectively.

Adding blocks

Each theme has a slightly different set of custom block styles, but they’re all built upon the same set of configurable properties.

Customizing custom blocks in Zendesk Guide

SettingDescription
Custom blocks styleThe built-in block style to use. Selecting “None” will hide the custom blocks from the Home page.
Custom blocks colorThe color palette to use, which references colors defined in your theme. Each block style uses color palettes a little differently and you can use any color you like by modifying the custom micro-template.
Custom blocks background colorThe background color to use for the custom blocks section.
Custom blocks headingThe optional heading text to display above the custom blocks.
Custom block numberThe number of custom blocks to display (between 1 and 4).
Custom block columnsThe number of columns to display the blocks in (between 1 and 4).
Custom block alignmentThe alignment of each custom block (left or center).
Custom block image heightThe height of each custom block image. If the setting is blank, images will not be displayed.

You can then configure the following properties for each custom block:

PropertyDescription
TitleThe title of the custom block.
DescriptionThe description of the custom block.
LinkThe URL of the custom block that users will be sent to.
ImageThe image of the custom block.

The images for each of the 4 supported custom blocks are configured in the Images setting group, whereas the other settings are in the Custom blocks setting group.

Customizing blocks

Each theme comes with a number of built-in custom block styles that you can choose from using the Custom blocks style theme setting, but you can add additional custom block styles to your theme by:

  1. Editing the micro-template of your chosen custom block style on the footer.hbs template.

  2. Copying a custom block style across from another theme if you have other Zenplates themes.

  3. Adding a custom block element with the visual builder.

All custom block micro-templates build upon the same set of theme settings but can differ significantly in terms of their look-and-feel and behavior. You can also add more than 4 custom blocks to the theme, if desired, with some simple template changes.

Custom blocks are built to be customized, so the only limit is your imagination.

Questions or feedback about this article? Let us know