Hosting HelpDocs at a Subfolder of Your Site

By default HelpDocs comes with a subdomain (e.g. and a custom domain (e.g. They're great for SEO by default (Google's pretty good at working out which content's yours now!) and for most customers there's no need to change things.

There's some cases, though, that it's desirable to integrate your docs more into your site. 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.

Embedding with an iframe 

You can easily add an iframe to your HelpDocs subdomain from anywhere on your site. This is a little tricky to make look awesome, but we have some customers that've done this super successfully.

<iframe src="" height="500" width="1000"></iframe>

You can even update URLs in the address bar when people click links. You'd need to write a little custom Javascript inside your HelpDocs and on the page where you're embedding it. Then use something like easyXDM to send messages between the two. You'll want to do that on page loads at either end.

Advanced: Using a reverse proxy

You can also reverse proxy your docs through something like nginx. You'll need set up a listen block to rewrite the URL of your subfolder to your HelpDocs subdomain, like this:

location /help/ {
              resolver     ;
              set                    $proxy_pass_url;
              rewrite                ^/help/(.*)        /$1 break;
              proxy_pass             $proxy_pass_url;
              proxy_ssl_server_name  on;

Then in the HelpDocs dashboard, include the subfolder in Settings > General > Custom Domain. So that'll look something like

We'll take care of rewriting all the internal links our side.

Debugging nginx

nginx is an awesome reverse proxy...until it's not. Depending on your setup, you may experience a variety of problems getting this working, especially when you're working with SSL and load balancers. If you're having problems, try experimenting with these options:

OptionPossible Value(s)
proxy_ssl_nameYour HelpDocs subdomain host (e.g., your custom domain host (e.g.
proxy_set_header$host, your HelpDocs subdomain host (e.g.
We can't help you with the specifics of embedding or reverse-proxying your site, but if need anything different on the platform to make your implementation easier we're always happy to take feedback!
We only support one level subfolder hosting, but you’re welcome to try and do loads if you’re an nginx wizard 🌟

What did you think of this doc?