A blog project uses HelpGuides to publish a blog instead of a documentation site. It has the same editor, search and AI tools, but the site, the admin screens and the SEO markup are built around dated posts rather than a category tree.
New projects are created as documentation projects, and the project type can't be changed from Settings. To set up a blog project, contact support.
Once your project is a blog, the left navigation adds Categories and Ads, and Content shows a list of posts instead of the category tree.
Click Content to see all your posts. The list shows each post's Title, Author, Categories, Status, Views, Created date and Published date.
To plan when posts go out, set a future publish date in the editor and use the Calendar page to see what's scheduled.
Click Categories in the left navigation. Your categories are listed on the left; click one to see its description and the posts in it, with each post's status and URL.
The category fields are the same as in documentation projects. See Organizing Content with Categories.
Ads let you promote your own offers, such as a guide, a webinar or a free trial, inside your blog posts. Click Ads in the left navigation. There are two kinds, each on its own tab:
| Tab | Where it appears |
|---|---|
| Inline | Inside the post, before the third h2 heading (or before the eighth paragraph if the post has fewer headings). Inline ads can include an image |
| Footer | At the end of the post. Footer ads don't use an image |
A post shows at most one inline ad and one footer ad.
Click Add Inline Ad or Add Footer Ad, fill in the three tabs and click Create.
| Tab | Field | Used for |
|---|---|---|
| Content | Title | The ad's headline. Required |
| Content | Body text | A short description below the title. Required |
| Content | Destination URL | Where the ad links to. Required |
| Content | Button / CTA | The button label, for example "Get the guide". Required |
| Content | Use custom colors | Turn on to set a Background color and Text color. Leave off to match the blog theme, including dark mode |
| Image | Ad Image | The picture shown in inline ads |
| Image | Layout | Two columns — image beside text or Single column — image on top, text below |
| Targeting | Keyword triggers | Semicolon-separated keywords, for example email; inbox; deliverability. Leave empty to make this a default ad |
| Targeting | Sort order | Breaks ties between ads that match equally well. Lower numbers win |
| Targeting | Enabled | Show this ad on the blog. Turn off to pause an ad without deleting it |
For each post, HelpGuides compares every enabled ad's keyword triggers with the post's keywords and shows the best match for each slot:
pickleball matching pickleball registration.A post's keywords are in the editor under Advanced → SEO → Keywords. They're generated automatically, and you can edit them.
Each ad in the list shows how many times it has been clicked. Use this to compare offers and retire ads that don't perform.
Blog post URLs end with a trailing slash, for example https://blog.example.com/my-first-post/.
Each post includes BlogPosting structured data with the headline, description, publish and modified dates, featured image, keywords, the author as a Person (with their URL, photo and bio when set), and your site as the publisher, with its logo. See Structured Data.
Your blog has an RSS feed at /feed and a JSON feed at /site.json, both newest first. Every page links to the RSS feed, so feed readers can find it from any post. See Feeds and Machine-Readable Formats for paging and filtering.
example.com/blog