# 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.

Source: https://www.zenplates.co/documentation/customization/adding-custom-blocks (Customization › Using theme settings)

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](https://www.zenplates.co/documentation/customization/adding-content-blocks) and [contact blocks](https://www.zenplates.co/documentation/customization/adding-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](https://www.zenplates.co/assets/images/documentation/customizing-custom-blocks.webp)

| Setting                        | Description                                                                                                                                                                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Custom blocks style            | The built-in block style to use. Selecting "None" will hide the custom blocks from the Home page.                                                                                                                                                                                           |
| Custom blocks color            | The 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](https://www.zenplates.co/documentation/customization/using-micro-templates). |
| Custom blocks background color | The background color to use for the custom blocks section.                                                                                                                                                                                                                                  |
| Custom blocks heading          | The optional heading text to display above the custom blocks.                                                                                                                                                                                                                               |
| Custom block number            | The number of custom blocks to display (between 1 and 4).                                                                                                                                                                                                                                   |
| Custom block columns           | The number of columns to display the blocks in (between 1 and 4).                                                                                                                                                                                                                           |
| Custom block alignment         | The alignment of each custom block (left or center).                                                                                                                                                                                                                                        |
| Custom block image height      | The 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:

| Property    | Description                                             |
| ----------- | ------------------------------------------------------- |
| Title       | The title of the custom block.                          |
| Description | The description of the custom block.                    |
| Link        | The URL of the custom block that users will be sent to. |
| Image       | The 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](https://www.zenplates.co/documentation/customization/using-micro-templates) 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](https://www.zenplates.co/documentation/visual-builder/adding-elements).

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.
