For directory owners, listing sites and local guides
WordPress directory pages for every category and city, only where you have listings
Export a summary from your directory: listing count, price range and neighborhoods for each category in each city. PageForge turns every row that meets your minimum into a page with your listings block, a hub link and honest schema.
- Free on WordPress.org
- Hub pages grouped by city
- Update counts from a new CSV
The directory thin-page problem
A page for every category and city is mostly empty pages
A directory can produce thousands of category and city combinations. Most hold one listing or none, and a visitor who lands on an empty page leaves without contacting anyone.
How directory pages usually get built
- Empty category and city combinations get indexed next to the useful ones
- City pages share one intro paragraph with the name swapped
- Counts and price ranges are typed once and never updated
- A new city gets no page until someone builds one by hand
With PageForge
- Only rows that meet your listing minimum become pages
- Each page carries its own count, price range, neighborhoods and booking note
- A new export and one update run refresh every number
- A hub page lists every published city, grouped by city or state
The data
One row per page, every detail that changes
Category, City and State build the title and URL. Listings, PriceRange, Areas and BookingNote are the summary that makes the Seattle page different from the Boise one, and CategorySlug feeds your listings shortcode.
| Category | City | State | Listings | PriceRange | Areas | BookingNote | CategorySlug | |
|---|---|---|---|---|---|---|---|---|
| 2 | Mobile Dog Grooming | Portland | OR | 12 | $65-$110 | Sellwood; St. Johns; Hawthorne | Most groomers book 1 to 2 weeks ahead | mobile-dog-grooming |
| 3 | Cat Grooming | Portland | OR | 5 | $55-$90 | Pearl District; Hawthorne | Two listings offer sedation-free grooming | cat-grooming |
| 4 | Mobile Dog Grooming | Seattle | WA | 18 | $70-$120 | Ballard; Capitol Hill; West Seattle | Weekend slots fill first | mobile-dog-grooming |
| 5 | Dog Daycare | Seattle | WA | 23 | $38-$52 per day | Fremont; South Lake Union; Columbia City | Most require a trial day | dog-daycare |
| 6 | Dog Daycare | Tacoma | WA | 9 | $32-$45 per day | Stadium District; Proctor | Three listings have outdoor yards | dog-daycare |
| 7 | Mobile Dog Grooming | Boise | ID | 7 | $60-$95 | North End; Bench | Several cover nearby towns for a fee | mobile-dog-grooming |
| 8 | Dog Training | Spokane | WA | 11 | $40-$85 per session | South Hill; Kendall Yards | Group classes start monthly | dog-training |
Placeholders
{Category} {City} {State} {Listings} {PriceRange} {Areas} {BookingNote} {CategorySlug}
Patterns
Title{Category} in {City}, {State}
URL/{category}-{city}-{state}/
Campaign size
8 categories × 60 cities = 480 possible pages, published only where listings exist
Pages this creates
- Mobile Dog Grooming in Portland, OR
- Cat Grooming in Portland, OR
- Dog Daycare in Seattle, WA
- Dog Daycare in Tacoma, WA
- Dog Training in Spokane, WA
How it works
From a listing export to published city pages in four steps
01
Export a summary per category and city
Count the listings, take the price range and list the neighborhoods covered. Drop every row below your minimum before you save the CSV.
02
Build one city page template
Write the page around the summary, then place your directory plugin’s listings shortcode with its category and city filled from {CategorySlug} and {City}.
03
Check and preview
See how many pages will be created or skipped, the first page’s title and URL, and any two rows that produce the same address. Nothing is written yet.
04
Generate, add a hub, refresh the numbers
Generate drafts, compare each summary with the listings it shows, then publish. When counts change, export again and run in update mode.
Built for listing sites
Every city page, filled from your own listing data
Your directory plugin holds the listings. Your export holds the summary. PageForge turns each summary row into a page that sits in front of the listings.
One generated page
What a dog owner sees on Mobile Dog Grooming in Portland, OR
The page answers three questions before the list starts: there are 12 mobile groomers, they charge $65 to $110, and they cover Sellwood, St. Johns and Hawthorne. The booking note warns that most book one to two weeks ahead, then the filtered listings follow. Owners who know the price and the wait before they call are the ones who book.
- Count, price range and areas come from the row
- The booking note sets expectations before the call
- The listings block is filtered to the category and city
Hubs
Give every city page a link from a state index
PageForge Free adds no links between generated pages by itself, so a hub does that job. Add the PageForge Sitemap block to an index page, group it by state or city, and link the index from your main menu.
- Group headings come from the City and State columns
- Counts per group show where your listings are deep
- Free lists only published pages PageForge generated
Structured data
Schema that says you list businesses, not that you are one
Every generated page gets one JSON-LD block with your business item and a WebPage item. A CSV with Service and City columns would add a Service item naming your site as the provider, which is wrong for a directory, so the sample uses Category instead.
- Set Business Type (Schema) to Organization
- Keep the column named Category, not Service
- Validate one page before you generate the rest
Compared
PageForge versus building directory city pages by hand
A good city page looks the same either way. Keeping 60 of them accurate is where the methods split.
| PageForge | Building city pages by hand | |
|---|---|---|
| Count, prices and areas on each page | From your export | Typed once, rarely updated |
| Pages only where listings meet your minimum | Filter the export | Depends on who remembers |
| Duplicate URL check before writing | Yes | No |
| Hub page linking every city | Sitemap block, grouped by city or state | Kept up to date by hand |
| Refreshing counts on 60 pages | One update run | 60 separate edits |
| Draft a page when its row is removed | Sheets sync on Professional and Enterprise | By hand |
| Rows per run | Up to 100 in Free, no limit in Pro | One at a time |
WordPress directory pages: what they are for
WordPress directory pages are the category and city pages a listing site publishes in front of its listings: “Mobile Dog Grooming in Portland, OR”, “Dog Daycare in Tacoma, WA”. Each one gives a visitor a short summary of the options in that place, then the listings themselves.
PageForge builds those pages from a CSV. Each row is one category in one city, carrying the summary your directory already knows: how many listings, the price range, the neighborhoods covered and a booking note. One template turns every row into a WordPress Page with its own title, URL, meta description and schema. The listings stay in your directory plugin.
The sample is a hypothetical pet services directory covering Oregon, Washington and Idaho. Every number below comes from its seven rows.
The searches behind category and city pages
Directory searches pair a category with a place:
- “mobile dog grooming portland”
- “dog daycare tacoma”
- “dog trainer spokane”
- “cat groomer pearl district”
The visitor wants options, not one business. They want to know how many there are, what they cost and whether anyone covers their part of town. A page that answers those three questions before the list starts is doing the job a directory exists for. A page with a heading and an empty list is not.
What goes in each row
| Column | Where it appears | Row 1 value |
|---|---|---|
| Category | Title, heading, URL | Mobile Dog Grooming |
| City | Title, URL, hub grouping | Portland |
| State | Title, URL, hub grouping | OR |
| Listings | The “12 options” line and the meta description | 12 |
| PriceRange | Prices section | $65-$110 |
| Areas | Neighborhoods covered | Sellwood; St. Johns; Hawthorne |
| BookingNote | Booking tips | Most groomers book 1 to 2 weeks ahead |
| CategorySlug | Your listings shortcode’s category filter | mobile-dog-grooming |
Every value should come from your listing data, not from memory. That is what makes the Seattle page different from the Boise page, and it is what you can defend when a business owner asks where a number came from.
The Areas values use semicolons, and that is safe. PageForge picks the delimiter from the header row, which uses commas, so a semicolon inside a cell is just text. See Prepare your CSV.
Name it Category, not Service
When a CSV has Service and City columns, PageForge adds a Service item to each page’s schema, naming your site as the business that provides that service. A directory does not groom dogs. Keep the column called Category and the pages describe your site honestly.
Worked example: seven pet-service pages from the sample CSV
The sample covers 4 categories in 5 cities across 3 states, with 85 listings in total. With the Title Pattern {Category} in {City}, {State} and the Slug Pattern {category}-{city}-{state}:
| Row | Page title | URL | Listings |
|---|---|---|---|
| 1 | Mobile Dog Grooming in Portland, OR | /mobile-dog-grooming-portland-or/ | 12 |
| 2 | Cat Grooming in Portland, OR | /cat-grooming-portland-or/ | 5 |
| 3 | Mobile Dog Grooming in Seattle, WA | /mobile-dog-grooming-seattle-wa/ | 18 |
| 4 | Dog Daycare in Seattle, WA | /dog-daycare-seattle-wa/ | 23 |
| 5 | Dog Daycare in Tacoma, WA | /dog-daycare-tacoma-wa/ | 9 |
| 6 | Mobile Dog Grooming in Boise, ID | /mobile-dog-grooming-boise-id/ | 7 |
| 7 | Dog Training in Spokane, WA | /dog-training-spokane-wa/ | 11 |
Check and preview would report Ready: 7 new, 0 to update, 0 skipped. The state in the slug matters: without it, a Portland, Maine row added later would clean up to the same URL as Portland, Oregon, and the second row would be skipped as a duplicate. See Duplicate URLs and skipped rows.
Apply your minimum
With a minimum of three listings, all seven rows qualify. Raise it to six and row 2, Cat Grooming in Portland with five listings, drops out, leaving six pages. Decide the number before you export, and apply it the same way every time.
Rows that need more data
- Price units are inconsistent. Daycare says “per day” and training says “per session”, but the four grooming rows (1, 2, 3 and 6) give a bare range. Add “per visit” so “$65-$110” means something to a reader.
- Four rows list only two neighborhoods: Cat Grooming in Portland, Dog Daycare in Tacoma, Mobile Dog Grooming in Boise and Dog Training in Spokane. If your listings cover more areas, add them. If they do not, the page is honest as it stands.
- Counts go stale. Add a column such as CountedOn with the export month, and show it next to the count, as in “12 listings, counted in March”.
Meta descriptions
The pattern Compare {Listings} {Category} listings in {City}, {State}. Prices {PriceRange}. Areas: {Areas}. gives 93 to 120 characters across the seven rows, well inside a typical snippet. Boise is shortest at 93 and Dog Daycare in Seattle longest at 120. Because the count sits in the description, refresh it whenever the count changes.
The hub
Grouped by state, the PageForge Sitemap block on an index page would show OR with 2 pages, WA with 4 and ID with 1. Grouped by city, Portland and Seattle get two links each and Tacoma, Boise and Spokane one each.
What to put on every page
- The category and city in the heading, matching the title.
- The listing count from your data, with the date it was counted.
- The price range with its unit: per visit, per day or per session.
- The neighborhoods covered, so a visitor knows whether anyone serves them.
- One booking note a local would tell a friend, such as how far ahead to book.
- The listings themselves, filtered to that category and city.
- Links to the same category in nearby cities, and to the state or city hub.
- A way for a business to add or claim a listing, if your directory offers one.
WordPress directory pages and Google’s spam policies
Directories are where scaled pages go wrong fastest. Eight categories across 60 cities is 480 possible pages, and many of those pairs hold one listing or none. Google’s spam policies describe doorway pages, built to rank for close variations of a search, and content made in bulk that adds little value. An empty category and city page fits both descriptions.
Three rules keep a directory on the right side:
- Publish where you have listings. The minimum is the whole strategy. Rows below it stay out of the CSV.
- Summarize, do not pad. A count, a price range and three neighborhoods are worth more than three paragraphs of general copy about dog grooming.
- Keep the numbers true. A page that says 12 groomers above a list of four loses the visitor’s trust, and the trust of the businesses you list.
See doorway pages versus location pages for where the line sits, and the quality checklist for the review before each run.
Showing the listings
PageForge creates Pages, Posts or its own content type. It does not create, import or edit the listings in your directory plugin.
To show the listings on each page, use your directory plugin’s shortcode or block, if it offers one with category and location settings. Put it in the template and fill those settings from the row, for example a category of {CategorySlug} and a city of {City}. PageForge fills the placeholders when it writes each page, and your plugin renders the current listings when the page loads.
If your plugin names locations differently from your CSV, such as a location slug instead of a city name, add a column holding the plugin’s own value and use that in the shortcode. Generate three drafts and confirm each one shows its own listings. A filter left on its default shows the same listings everywhere.
Schema for a directory
Each generated page gets one JSON-LD block with two items: your business, using the type you pick under Business Type (Schema), and a WebPage item with the page’s title, URL and featured image. For a directory, choose Organization. LocalBusiness would describe your site as a local business, which it is not.
PageForge does not add FAQ, Review, Breadcrumb or Event schema. If you want list or review markup, it has to come from your directory plugin or SEO plugin, and you should check one page for a second business item. Details are in schema markup.
Hubs, parents and URLs
PageForge Free adds no links between generated pages by itself. Hubs do that job.
- One index page. Add the PageForge Sitemap block, or
[pageforge_sitemap post_type="page" group_by="state"], to a “Pet services by city” page. Free lists published generated pages, grouped by the City, State or Service column of each row, with a count per group. See hub pages with the sitemap block. - State hubs as parents. Create a Washington hub page first, choose it as the template’s Parent Page, and every page from that template sits beneath it. Free sets one parent per template, so use one template and one CSV per state. Pro, from Starter, reads the parent from a Parent Path column. See parent pages.
- Nearby cities. Seattle and Tacoma are close neighbors. Add a column with the URL of the nearest city’s page for the same category and write that link into the template.
Keeping counts current
Listings come and go. When counts or prices move, export the summary again, upload it on PageForge > Data Sources and run the same template with Update it from the CSV and current template. PageForge refreshes the pages whose rows changed, reports the others as unchanged, and skips pages someone edited by hand unless you tick the overwrite option. See Update pages you already generated.
Update runs never remove pages. When a city drops below your minimum, set its page to draft yourself, or mark it noindex in your SEO plugin until the listings return.
On the Professional and Enterprise plans, a Google Sheets sync can do both jobs on a schedule: changed rows update their pages, and a removed row can send its page to draft once you have previewed and applied the sync. See Google Sheets to WordPress.
Common mistakes
- Publishing the full grid. 480 pairs is the ceiling, not the plan.
- A column called Service. It adds Service schema naming your site as the provider.
- Estimated counts. Every number should come from the export.
- Price ranges without units. “$38-$52” could mean per hour or per day.
- A slug without the state. Two Portlands, one URL.
- A listings filter left on its default. Every page shows the same listings.
- No hub. Pages that nothing links to are hard to find, for visitors and for crawlers.
How to run it in PageForge
- Export the category and city summary from your directory, filtered to rows at or above your minimum, and save it as CSV UTF-8.
- Open PageForge > Data Sources, choose the file under CSV Upload and click Upload CSV.
- Build the city page in your page builder with the summary sections, the listings shortcode and a placeholder for every column.
- In PageForge > Templates, click Add New Template. Set Target Post Type to Page, the Title Pattern to
{Category} in {City}, {State}and the Slug Pattern to{category}-{city}-{state}. Choose your page as Base Layout to Clone. - In PageForge > Settings, set Business Type (Schema) to Organization.
- On the Generate screen, set Post Status to Draft and click Check and preview. For the sample, expect 7 new pages and none skipped.
- Click Generate 7 pages now, check each page’s listings against its count, publish, then add the Sitemap block to your index page.
Free or Pro for directories
The free plugin runs the whole workflow, up to 100 rows per run, which suits a first state or a first set of categories. Pro has no row limit.
| You need | Pro feature | Plan |
|---|---|---|
| The full category and city grid in one run | No per-run row limit | Every Pro plan |
| Pages going live a few a day | Queue, scheduler and daily limit | Every Pro plan |
| State hubs filled from one file | Parent page per row | Starter and higher |
| A photo per city page | Featured image from a column | Every Pro plan |
| Counts kept in step with a sheet | Google Sheets sync | Professional and Enterprise |
Compare editions on Free vs Pro.
Use cases
Blueprints with a sample CSV included
{Service} in {City}, {State}One page per service and suburb for plumbers, electricians, cleaners and other trades.6 services × 40 suburbs = 240 pagesSee the blueprintTravel and destinations{Activity} in {Destination}, {State}One page per tour per launch site, with its own price, duration, season and meeting point.6 tour types × 7 launch sites = 42 pages, only where you run that tourSee the blueprintAffiliate and comparison pages{ProductA} vs {ProductB} for {UseCase}Comparison pages built from your own testing notes, kept current as your picks change.10 models make 45 pairs; 45 pairs × 3 use cases = 135 possible pagesSee the blueprintWill Google see category and city pages as doorway pages?
It can, if the pages exist only to catch searches and hold nothing useful. Google’s spam policies name doorway pages and content made in bulk that adds little value. A directory page earns its place when it lists real options in that city and summarizes them: how many, what they cost, which areas they cover. Publish only where your listings meet a minimum you set.
How many listings should a page have before I publish it?
Set a minimum and apply it before you export. Three listings is a sensible floor for most categories, because a visitor needs options to compare, and a category where people shop around may deserve more. In the sample, a minimum of six would drop Cat Grooming in Portland, which has five listings, and leave six pages.
Does PageForge import or create the listings?
No. PageForge creates Pages, Posts or its own content type from your rows, and your listings stay in your directory plugin. The CSV holds only the summary for each category and city. To show the listings themselves, place your directory plugin’s shortcode or block in the template and fill its filters from the row.
Why should the column be called Category and not Service?
Because Service and City columns make PageForge add a Service item to each page’s schema, naming your site as the business that provides the service. A directory does not groom dogs or run a daycare, so that markup would be false. Name the column Category and the pages get only your business item and a WebPage item, which is accurate.
How do I keep listing counts and prices current?
Export the summary again, upload it and run the same template with Update it from the CSV and current template. Pages whose row changed are refreshed, the rest are reported as unchanged, and pages someone edited by hand are skipped unless you choose to overwrite them. Pick a rhythm that matches how fast your listings change, such as monthly.
What happens when a city drops below my minimum?
In the free plugin, an update run never removes pages, so set that page to draft yourself or mark it noindex in your SEO plugin until listings return. On the Professional and Enterprise plans, a Google Sheets sync can move a page to draft or the trash when its row is removed, once you have previewed and applied the sync.
I have 480 category and city combinations. Can the free plugin handle that?
The free plugin runs up to 100 rows per run, which suits a first state or a first set of categories. PageForge Pro has no row limit and can queue rows for a background scheduler that publishes up to a daily limit you set. Apply your listing minimum first: the full grid counts every empty pair, and those rows should not become pages anyway.
Can I nest city pages under state hub pages?
Yes, when the template creates native Pages. Create the state hub first, choose it as the template’s Parent Page, and every page from that template sits beneath it. The free plugin sets one parent per template, so use one template and CSV per state. Pro, from the Starter plan, reads the parent from a Parent Path column instead. Parent pages must exist before the run.
Publish the cities where your listings are
Install the free plugin, upload the sample CSV and generate the seven pet-service pages as drafts. Check each summary against its listings before anything goes live.
