---
title: "Hub pages with the sitemap block"
description: "List your generated pages on a hub page with the PageForge Sitemap block or the [pageforge_sitemap] shortcode, grouped by city, state or service."
url: https://pageforge.pro/docs/sitemap-hubs/
type: pfs_doc
published: 2026-11-18T13:39:06+00:00
updated: 2026-11-18T13:54:59+00:00
author: "PageForge"
language: en-US
---

# Hub pages with the sitemap block

> List your generated pages on a hub page with the PageForge Sitemap block or the [pageforge_sitemap] shortcode, grouped by city, state or service.

A hub page links to every page in a campaign. A plumbing company with 40 city pages can publish one “Areas we serve” page that links to all of them. Visitors find their city faster, and search engines get a clear path to each page instead of relying on the XML sitemap alone.

## Add the block

1. Create or edit the hub page in the block editor.
2. Add the **PageForge Sitemap** block. It sits in the **PageForge Blocks** category.
3. Choose the settings in the sidebar and publish.

The block and the shortcode render the same list, so you can use either one.

## Shortcode options in Free

| Attribute | Values | Default |
| --- | --- | --- |
| `post_type` | Comma-separated post types | `pageforge_page,page,post` |
| `group_by` | `city`, `state`, `service` or `none` | `city` |
| `columns` | 1 to 6 | 3 |
| `limit` | Up to 5000 | 1000 |
| `show_counts` | `true` or `false` | `true` |
| `heading_level` | 2 to 4 | 3 |
| `style` | `cards`, `compact` or `minimal` | `cards` |
| `accent_color`, `background_color`, `link_color` | Hex colors | `#1f4b59`, `#ffffff`, `#0f766e` |

In Free the list always contains published pages that PageForge generated, sorted by title. Group headings come from the City, State or Service columns of each page’s row. Pages without that value are grouped under a fallback heading such as “Other Cities”. The block offers the same choices under **Sitemap Settings** and **Appearance**.

## Shortcode options in Pro

Pro uses a wider set of attributes, for example:

| Attribute | What it does |
| --- | --- |
| `generated_only` | `1` lists only PageForge-generated content. Default `0` lists all published content of the chosen types. |
| `anchor_source` | Link text: `title`, `meta_title`, `service_city` or `custom` (with `label_template`) |
| `description_source` | Text under each link: `none`, `excerpt` or `meta_description` |
| `layout` | `columns`, `grid` or `list` |
| `orderby` and `order` | `title`, `date`, `modified`, `menu_order` or `name`, with `ASC` or `DESC` |
| `include` and `exclude` | Comma-separated post IDs |
| `group_by` | `none` or `post_type` |
| `heading` and `heading_tag` | An optional heading, `h2` to `h4` |
| `include_home`, `nofollow`, `class` | Add the home page, add nofollow to links, add a CSS class |

In the Pro block these appear under **Sitemap Content**, **SEO Labels** and **Layout**.

**Note** Free ignores the Pro-only attributes. A shortcode copied from a Pro site, such as one with `anchor_source`, still renders in Free, but with Free’s grouping and styling.

The older  shortcode name also works in both editions.

## Tips for useful hub pages

- Link the hub from your main navigation or footer, so it is reachable from every page.
- Group by service or city so visitors can scan the list.
- If you generate native Pages under a Parent Page, the parent itself can be the hub. Add the block to it.
- Write a short introduction above the list that explains what the pages cover.

Next: [Parent pages](https://pageforge.pro/docs/parent-pages/) and [Quality checklist before you publish](https://pageforge.pro/docs/quality-checklist/).

---

Source: https://pageforge.pro/docs/sitemap-hubs/ · PageForge
