Skip to main content

Customizing your HelpDocs

There's a ton of ways to customize your HelpDocs. You can upload your logo, easily change your brand colors, or upload custom CSS and JavaScript.

author avatar author avatar
41 docs by 2 team members
Category icon
18 docs

Code Snippets

We get asked about customizing HelpDocs a lot, and our Engineers love to help. Here's some of the common CSS and JavaScript snippets we get requests for.
Category icon
2 docs

Custom HTML Templates

Wanna go crazy and customize everything? Use HTML and Handlebars to create a custom template for your docs.

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Choosing a Template

HelpDocs ships with a bunch of different layouts so you're bound to find something you love. 💖

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Adding Icons to Articles

HelpDocs allows adding icons to articles to add a bit of extra style to your docs. Custom icons can be uploaded too.

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Changing the Language in Common Phrases

If you're looking to support non-English and international customers with HelpDocs, you can change the contents of strings to match the language 🌍

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Setting Article Display Order

There's a few different ways to set the order that articles appear on your HelpDocs: Alphabetical, Created Dated, Last Updated, Random, or Custom.

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Hosting HelpDocs at a Subfolder of Your Site

By default HelpDocs comes with a subdomain and a custom domain. If you need to, it's possible to host your HelpDocs at a subfolder of your own domain, and there's a couple ways to do that.

A simple icon of a bookmark with a star near the bottom to represent a featured article A simple ribbon icon. It has a slightly rounded border and a star at the bottom of it. ​ Testing Customizations with .dev

Customize the look and feel of your docs without breaking anything in production with .dev.

Understanding the Contact Form

You can't cover every question your customers might have in your HelpDocs. That's where the Contact Form comes in. 📮

Customizing an Article Slug, Meta Description & Short Version

When you first get started writing your articles, you'll notice a lot of the advanced stuff is automatically done for you. However, if you're a whizz and want to customize the way things are displayed on your knowledge base, you can!

Adding Multiple Domains

Host multiple custom domains for your content so you can share your help under different brands.

Adding Icons to Categories

HelpDocs ships with the ability to choose from a library of icons and easily add them to your categories.

Managing Open Graph Fallback Images

Open Graph protocol makes links on social look great. HelpDocs automatically pulls the first image from an article and uses it as the Open Graph image. You can add a Fallback Image for when there are no images in the article.

Setting a Custom Favicon

Favicons let your users easily identify your website from the URL bar. It's like a teeny little version of your logo that browsers show you occasionally. HelpDocs lets you add a custom one. ✨

Hiding the Contact Button

When you sign up to HelpDocs, you'll automatically be given a contact button in the upper-right-hand side of the header. If you don't need it, you can remove it in a jiffy.

Adding Custom CSS

When you set up your HelpDocs account, you'll have the option to choose your layout and customize things like the logo and brand color. If you're looking to customize the layout even further, you can add custom CSS.

Adding Custom Navigation Links

Your help documentation is an important part of your site, but sometimes you'll want to add links to other places. HelpDocs makes it easy to add custom navigation links to the header.

Setting Category Display Order

There's a few different ways to set the order that categories appear on your HelpDocs: Alphabetical, Created Dated, Last Updated, Random, or Custom.

Uploading Your Brand Logo

You'll want to make your help documentation look like part of your own site. Adding your brand logo to your HelpDocs is super easy. ✨

Adding URL Redirects

Over time, it's normal for links to change. But sending a customer to a 404 error page isn't the best experience (although ours are pretty cool!). With HelpDocs, you can redirect your customers to a new URL so they find what they're looking for right away.

Featuring a Category

Featuring is a great way to promote your best and most important categories in HelpDocs. Here's how to feature them.

Adding Custom JavaScript

Brand settings just not enough and wanna go even further to make it your own? Know a little JavaScript? With HelpDocs you can add as many custom scripts as you like.

Adding Cookie Consent

No doubt you've seen Cookie Consent banners around the web in the last few years. They give visitors a heads up users about being tracked. HelpDocs comes with the ability to enable a cookie consent b…

Get in touch

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.