---
title: "Adding Icons to Articles"
description: "HelpDocs allows adding icons to articles to add a bit of extra style to your docs. Custom icons can be uploaded too."
url: "https://support.helpdocs.io/article/sxq6nk86vc-adding-icons-to-articles"
category: "Customizing your HelpDocs"
updated_at: "2026-09-12T11:14:10Z"
---

# Adding Icons to Articles

HelpDocs ships with the ability to choose from a library of icons and easily add them to your articles [and categories](/article/5nqIJibHzX-adding-icons-to-categories).

Adding icons to articles is not supported on every template. Check out [our feature matrix here](https://support.helpdocs.io/article/uQDebSnIrD-choosing-a-layout#feature_matrix) for more info.

### Adding Icons to Articles

**Pro tip**: Fancy using your own icon? On [our latest templates](/article/uQDebSnIrD-choosing-a-layout) (and [custom ones](/article/l8q1fmsnx7-getting-started-with-a-custom-html-template)) you can upload your own icon. We recommend using an SVG or an image around 100px by 100px.

[Embedded iframe](https://player.vimeo.com/video/1226170797)

1. Head to the editor page for the article you'd like to add an icon to
2. Click ![](https://files.helpdocs.io/Ytt2uahFxY/other/1785611918796/pencil-icon.svg) Article details in the top navigation
3. Under **Icon** choose **Set Icon**
4. Choose your icon
   
   1. You can pick from the **Icon** dropdown menu
   2. pick an emoji from the list[]()
   3. ...or click the upload icon to add a custom icon
5. Hit **Apply changes and close**

You'll also want to Save and Publish changes in the article editor before your icon will appear