HelpGuides supports serving your content through a reverse proxy, for advanced setups where your documentation or blog needs to live under a path on your main website.

What is Reverse Proxy?

For the sake of example, let's say you own a domain example.com. You have an existing website using that domain running WordPress where you host a blog: example.com/blog/example-name.

You then create a HelpGuides project at myproject.helpguides.io, and want to move your blog from WordPress to HelpGuides while keeping WordPress for your main website. A reverse proxy makes this possible.

How it works

Requests sent to example.com/blog/example-name are proxied to myproject.helpguides.io/example-name. The content is hosted at myproject.helpguides.io, but the browser URL and canonical URL remain example.com/blog/example-name.

Why use a reverse proxy?

Setting up a Reverse Proxy

Setting up a reverse proxy is an advanced task, but platforms such as Cloudflare make it relatively simple.

Reverse proxy with Cloudflare

Step 1 - Get your application domain

Without a reverse proxy, this is the address where your content is served. HelpGuides also supports custom subdomains.

Step 2 - Get your canonical path

Your canonical path is configured by the HelpGuides team. Once it's set up, you'll see it in Settings → Advanced → Canonical Path:

In this example, requests to https://helpguides.io/blog are mapped to the application domain https://vszh13.helpguides.io. Your setup would map, for example, https://yourdomain.com/blog to https://[your subdomain].helpguides.io. Once a canonical path is set, HelpGuides uses it for canonical URLs, sitemaps and feeds, and redirects visitors who go straight to the application domain.

Step 3 - Create a Cloudflare worker

Create a Cloudflare worker that forwards requests from your domain to your HelpGuides project. You'll need your Application Domain. The script below forwards any request whose path starts with /blog.

https://helpguides.io/blog/helpguidesio-now-supports-model-context-protocol-mcp

https://vszh13.helpguides.io/helpguidesio-now-supports-model-context-protocol-mcp

Replace the app_domain value with your own Application Domain, with no trailing slash. If you use a path other than /blog, change it throughout the script.

// Your HelpGuides Application Domain, with no trailing slash const app_domain = "https://vszh13.helpguides.io"; export default { async fetch(request, env, ctx) { const incomingUrl = new URL(request.url); // The blog home page: /blog or /blog/ if (incomingUrl.pathname === "/blog" || incomingUrl.pathname === "/blog/") { return fetchAndProcess(`${app_domain}/${incomingUrl.search}`, request, incomingUrl); } // All other blog paths, such as /blog/hello-world or /blog/site.json if (incomingUrl.pathname.startsWith("/blog/")) { const targetPath = incomingUrl.pathname.replace("/blog", ""); const targetUrl = `${app_domain}${targetPath}${incomingUrl.search}`; return fetchAndProcess(targetUrl, request, incomingUrl); } return new Response("Not Found", { status: 404 }); } }; // Forwards the request to HelpGuides and returns the response async function fetchAndProcess(targetUrl, originalRequest, incomingUrl) { const proxyRequest = new Request(targetUrl, { method: originalRequest.method, headers: new Headers({ ...Object.fromEntries(originalRequest.headers), "X-Forwarded-Host": incomingUrl.hostname // passes the root domain }), body: originalRequest.body, redirect: "manual" }); const originResponse = await fetch(proxyRequest); const contentType = originResponse.headers.get("Content-Type") || ""; // HTML: rewrite root-relative paths so assets load from HelpGuides if (contentType.includes("text/html")) { let html = await originResponse.text(); html = html.replace(/(href|src)=["']\/(?!\/)/g, `$1="${app_domain}/`); return new Response(html, { status: originResponse.status, headers: { "Content-Type": "text/html", "Cache-Control": "public, max-age=60" } }); } // Other file types (CSS, JSON, XML and so on) return new Response(originResponse.body, { status: originResponse.status, headers: originResponse.headers }); }

Step 4 - Add a route for the worker

In Cloudflare, add a route for the worker that matches your path, for example example.com/blog*, so requests under /blog go to the worker and the rest of your site is unaffected. Then open a few URLs under /blog to check that articles, images and search work.

Setup Reverse Proxy