You can create custom pages from scratch and then link to them from anywhere in your help center or from any other web page or application. For example, you can use custom pages to create special landing pages for your help center, or even create new pages to embed content from sources outside of Zendesk.
This article covers the following topics:
Creating custom pages
You can create custom pages in one of two ways. You can either create and customize a page using the Zendesk Curlybars and HTML markup within Guide's theming editor, or you can create and develop the page outside of Zendesk and then import it as part of a theme into the help center.
You can create up to 100 custom pages.
To create custom pages using the theme editor
- In Guide, click the Customize design icon (
) in the sidebar.
The Themes page opens.
- Click Customize on the theme that you want to edit.
- Click Edit code.
- Click Add new, then select Custom page.
- For Page name, enter a filename for your page.
The name becomes part of the page URL.
- Click Copy next to the URL field to save the URL to your clipboard.
You’ll need it to add the link to other pages.
- Click Add custom page.
The custom page appears without content and is listed under the custom_pages section in the sidebar.
To design the page, see Designing custom pages.
To create custom pages using code
As a developer, you can build themes offline and upload them as a ZIP file or use a GitHub repository. To create custom pages using code, create the page as a .hbs file in the following directory: templates/custom_pages. See Working on a theme locally.
Designing custom pages
When you create a custom page, the page is blank. To design a custom page, you can use the Zendesk templating language, also known as Curlybars, as well as HTML, CSS, and JavaScript.
For more information, see the following templating language references:
Linking to custom pages
Your content hierarchy is composed of a number of different pages such as sections and topics that make up your help center. Custom pages exist outside of this hierarchy and are not visible to users until they click a direct link to them.
For example, if you create an “About Us” custom page, you can add a link to that page from any help center template, article, or even home page. Users visiting those pages can click the About Us link to view the custom page. If users don’t have access to a link that points to the page, they can still search for it.
The URL of a custom page follows this pattern: "https://{domain_name}/hc[/{locale}]/p/{page_name}". The locale is optional and the page name does not include an .hbs or .html file extension. You can get the page_name from the list of pages in the theme editor. See Creating custom pages.
For example, if your domain name is mondocam.zendesk.com and the page name in the theme is about_us.hbs, the URL will be https://mondocam.zendesk.com/hc/p/about_us.
If you want to insert a link to the custom page in another page or template in the same help center, you can use a relative link such as <a href="/hc/p/about_us">About Us</a>.
50 comments
Niclas gmail
Why is {{#if signed_in}} not working in custom hbs, like it does in all the other hbs templates?
Are there other helpers which does not work?
1
Adam
Tetiana Gron
This is so infuriating. We are a small business and was hoping to use custom pages in our HC to get around some of the limitations of the guide, namely being able to display custom content for our logged in users such as their purchase history of custom objects. Unfortunately we have no need for 90% of the enterprise features and simply cannot warrant doubling the cost of our instance to move from Growth to Enterprise just to enable this. Our only choice now would be to try and hack this with articles but its certainly not as nice...
1
Rajan
add Custom page doesn't allow to upload .html file then how we can create a custom page in html instead of .hbs?
Jennifer Rowe
0
Gorka Cardona-Lauridsen
Hi Rajan the file format of Help Center theme templates including custom pages is .hbs which is the files we input in our serverside rendering engine. In the .hbs files you can use HTML, JS, CSS, Curlybars etc.; what is rendered to customers is an HTML page.
So if you have written a custom page as an HTML document in a theme you want to upload, all you need to do is to rename it to a .hbs file.
If your theme is already uploaded you can just create a blank custom page and paste all the HTML code and save it.
0
Veselin Bozhkov
0
Rajan
Gorka Cardona-Lauridsen What about the assets linking? Where should I upload them and How to access them?
0
Viktor Osetrov
Please accept my apologies
Could you please double-check your account rights? Ideally, you should be the admin/account owner for these types of changes.
Also, I realized that you have multiple accounts, it would be worth knowing for which account you have configured the changes.
Thanks
0
Lars Schweikardt
I have a question is it possible to create a custom page lets call it "categories" and in this I display all categories like in the basic template? We do not want to display the categories > sections > articles on the starting page but as mentioned in a sub page. Can you confirm that this is (not) possible? As far from what I have read is that I cant access any object within a custom page, but this seems quite a limitation I think
0
Jordan Lemaitre
Hello,
I have searched throughout the guide and have not found an answer to my question. My issue concerns customizing pages, as I would like to display a Custom Field on my page. Is there a way to do this? If so, do you have a link that can help me accomplish it?
0
Dane
I'm certain that it's not natively available. You can also look into Help center JavaScript cookbook maybe it can provide something useful to your use case.
You might be able to cobble something together making API requests to fetch custom field data, but that's custom code and wouldn't be something we'd support.
0
Michael Sutcliffe
Hello,
I hope someone can help me here, looking to add custom forms to a custom page.
Is this something that we can do?
0
Walter
Hi Michael Sutcliffe,
It's definitely possible. Any more details you can give?
0
Michael Sutcliffe
We are basically looking to take an exisiting form and place it into a custom page. This seems like a crazy thing for us to want to do, but we have an Internal KB that has 2 forms that our Internal Staff use.
We want to be able to embed the form into SalesForce for them, but without them having to login to the Internal KB each time. We wanted to pull the form into the Main KB but under a Custom page so that it cant be searched for.
Whats the best way to do this?
0
Johny Einarsson
Adam
I must agree. I endeavored to make a nice splash page for outages and system status but for doubling our monthly billing, no shot. Our company are legacy subs since 2012 and it's sad we can't have at least 1 or 2 measly custom pages for our patronage.
0
Neil
You can build a custom form on your own page using the Ticketing API as described here. This will require some API work though as this workflow isn't something that is offered out of the box. The best course of action is get in touch with your developer to help out.
0
Oren
browsing the api it seems you cant add customs page with it, that would very much help to have a way to automate an update to some of our custom pages.
Is postman page not updated?

0
Tony
thank you very much for your feedback. We really appreciate. They help us grow.
Best,
0
Albin Nilsson af Sillén
Is there a way to ex: use .env files for storing api keys securly in a custom page or any way to not show all the code (that is visible in the sources tab)?
0
Kokoro Ibaragi
Hi all,
Regarding this note:
> On Suite Growth and Professional or Support with Guide Professional, you have an option to add custom pages, but you won't be able to use them
Does that restriction apply to a custom page that is a part of an external theme too? For example, orgs with Guide Professional Plan using a theme containing a custom page within its code base can apply such themes but cannot publish custom pages in them?
As a big enterprise we have several brands and orgs that use zendesk with different plans and individual licensing contracts, while they use the same common code base for theming; some of our brands being not able to use custom pages depending on their licensing will break the planned functionality for us using custom pages in our common theme's code base.
0
彦祖
Hi, I want to add a custom form on the Custom page, what do I do
0