PageForge 1.3: check every run before it writes, update generated pages, spintax and resumable batches. See what changed
Account Get it free

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 sample spreadsheet feeds one template and becomes one page per row.

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.

directories.csv7 rows · 8 columnsDownload the CSV
CategoryCityStateListingsPriceRangeAreasBookingNoteCategorySlug
2Mobile Dog GroomingPortlandOR12$65-$110Sellwood; St. Johns; HawthorneMost groomers book 1 to 2 weeks aheadmobile-dog-grooming
3Cat GroomingPortlandOR5$55-$90Pearl District; HawthorneTwo listings offer sedation-free groomingcat-grooming
4Mobile Dog GroomingSeattleWA18$70-$120Ballard; Capitol Hill; West SeattleWeekend slots fill firstmobile-dog-grooming
5Dog DaycareSeattleWA23$38-$52 per dayFremont; South Lake Union; Columbia CityMost require a trial daydog-daycare
6Dog DaycareTacomaWA9$32-$45 per dayStadium District; ProctorThree listings have outdoor yardsdog-daycare
7Mobile Dog GroomingBoiseID7$60-$95North End; BenchSeveral cover nearby towns for a feemobile-dog-grooming
8Dog TrainingSpokaneWA11$40-$85 per sessionSouth Hill; Kendall YardsGroup classes start monthlydog-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.

Category and city pages from your export

Every column is a placeholder. {Listings}, {PriceRange} and {Areas} are what make the Tacoma daycare page worth reading.

Listings filtered per page

If your directory plugin has a listings shortcode with category and location settings, fill them from the row so each page shows its own listings.

Hubs grouped by city or state

The free Sitemap block lists your published generated pages grouped by city, state or service, with a count per group. One block builds the state index.

Schema that fits a directory

Set Business Type to Organization and name the column Category, not Service, so no page claims your site does the grooming itself.

New counts in one update run

Export again, upload and run in update mode. Changed rows refresh, unchanged rows are reported as unchanged, and hand-edited pages are skipped.

Pro

Google Sheets sync with safe removals

Keep the summary in a sheet. Changed rows update their pages, and a removed row can send its page to draft after you preview the sync. Professional and Enterprise plans.

A page generated from the first row of the sample spreadsheet.

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
A sitemap block lists generated pages on a hub page, grouped and linked.

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
Row values fill a JSON-LD template so every generated page carries its own structured data.

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.

PageForgeBuilding city pages by hand
Count, prices and areas on each pageFrom your exportTyped once, rarely updated
Pages only where listings meet your minimumFilter the exportDepends on who remembers
Duplicate URL check before writingYesNo
Hub page linking every citySitemap block, grouped by city or stateKept up to date by hand
Refreshing counts on 60 pagesOne update run60 separate edits
Draft a page when its row is removedSheets sync on Professional and EnterpriseBy hand
Rows per runUp to 100 in Free, no limit in ProOne at a time
Get PageForge free

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

ColumnWhere it appearsRow 1 value
CategoryTitle, heading, URLMobile Dog Grooming
CityTitle, URL, hub groupingPortland
StateTitle, URL, hub groupingOR
ListingsThe “12 options” line and the meta description12
PriceRangePrices section$65-$110
AreasNeighborhoods coveredSellwood; St. Johns; Hawthorne
BookingNoteBooking tipsMost groomers book 1 to 2 weeks ahead
CategorySlugYour listings shortcode’s category filtermobile-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}:

RowPage titleURLListings
1Mobile Dog Grooming in Portland, OR/mobile-dog-grooming-portland-or/12
2Cat Grooming in Portland, OR/cat-grooming-portland-or/5
3Mobile Dog Grooming in Seattle, WA/mobile-dog-grooming-seattle-wa/18
4Dog Daycare in Seattle, WA/dog-daycare-seattle-wa/23
5Dog Daycare in Tacoma, WA/dog-daycare-tacoma-wa/9
6Mobile Dog Grooming in Boise, ID/mobile-dog-grooming-boise-id/7
7Dog 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:

  1. Publish where you have listings. The minimum is the whole strategy. Rows below it stay out of the CSV.
  2. Summarize, do not pad. A count, a price range and three neighborhoods are worth more than three paragraphs of general copy about dog grooming.
  3. 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.
A sitemap block lists generated pages on a hub page, grouped and linked.

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

  1. Export the category and city summary from your directory, filtered to rows at or above your minimum, and save it as CSV UTF-8.
  2. Open PageForge > Data Sources, choose the file under CSV Upload and click Upload CSV.
  3. Build the city page in your page builder with the summary sections, the listings shortcode and a placeholder for every column.
  4. 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.
  5. In PageForge > Settings, set Business Type (Schema) to Organization.
  6. On the Generate screen, set Post Status to Draft and click Check and preview. For the sample, expect 7 new pages and none skipped.
  7. 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 needPro featurePlan
The full category and city grid in one runNo per-run row limitEvery Pro plan
Pages going live a few a dayQueue, scheduler and daily limitEvery Pro plan
State hubs filled from one fileParent page per rowStarter and higher
A photo per city pageFeatured image from a columnEvery Pro plan
Counts kept in step with a sheetGoogle Sheets syncProfessional and Enterprise

Compare editions on Free vs Pro.

Questions

Directory page questions

Still unsure? Ask in the chat or read the docs.

Will 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.

↑↓ to move↵ to open