Customizing your HelpDocs
Custom HTML Templates
Wanna go crazy and customize everything? Use HTML and Handlebars to create a custom template for your docs.
Choosing a Template
HelpDocs ships with a bunch of different layouts so you're bound to find something you love. If you're looking to create your very own layout, check out our article about creating a custom HTML templates.
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.
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.
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.
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. ✨
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.
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 Icons to Categories
HelpDocs ships with the ability to choose from a library of icons and easily add them to your categories.
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. ✨
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.
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 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.
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.
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 an Open Graph Fallback Image
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.