LocalPages How-To Guide

Dashboard Guide

Editing Guide

Tab 1 — Setup

The Setup tab is where you enter your core business details, branding, AI credentials, and URL preferences. You must complete this tab before anything else will work.

Business Information

Business Name (required) Your company name as it should appear on every location page. This is also used in the LocalBusiness schema markup that gets embedded in each page.

Business Description (required) Write 2–3 sentences that describe what your business does. This text is passed directly to the AI as context, so the more specific you are, the better the generated content will be. Example: "Acme Roofing is a family-owned contractor serving the Dallas–Fort Worth area since 2003, specializing in residential roof replacement and emergency storm repair."

Primary Service (required) The single main service you want every location page to rank for. Example: Emergency Plumbing or Roof Replacement. The city name is appended automatically during generation, so do not include a location here.

Target Keyword Variants A list of additional service phrases you want to rank for in each city — without the location name. Aim for 3–6 variants. Examples: roof replacement, emergency roof repair, metal roofing contractor. Click + Add keyword variant to add more rows, and the Remove button next to any row to delete it. The location is appended automatically during generation.

Phone Number (required) Your business phone number. Displayed on every location page and used in the click-to-call CTA button.

Format: +1 (555) 000-0000.

Street Address Your physical business address. If you are a service-area business (no public storefront), leave this blank. If you have a physical location, this must match your Google Business Profile address exactly for NAP consistency. It is embedded in the LocalBusiness schema on each page.

Website URL Read-only. Pulled automatically from your WordPress settings.

Business Type (required) Select the category that best describes your business. Options include: Plumber, Electrician, HVAC, Lawyer, Dentist, Contractor, Roofer, Landscaper, Pest Control, Auto Repair, or Other. This is used to produce relevant schema markup and AI prompts.

Years in Business How long you have been operating. Used as a trust signal in AI-generated content (e.g., "Serving customers for 15 years").

Service Area Type Choose between two options:

Single Location — you have one physical office and serve customers who come to you.

Service Area Business — you travel to customers and don't list a public address. Selecting this affects how the schema markup is structured.

Style Settings

Primary Color The brand color used for buttons, headings, and accents on your location pages. Click the color swatch to open the color picker, or type a hex value directly. Default: #2563eb (blue).

Dark Color The secondary dark color used for backgrounds and contrast sections. Default: #1a1a1a.

CTA Button Text The label on the primary call-to-action button on every location page. Default: Get a Free Quote. Change this to whatever makes sense for your business, such as Schedule an Inspection or Book Online.

CTA Link The URL the CTA button points to. This should be your contact form, booking page, or quote request page. Example: https://yourdomain.com/contact.

Phone CTA Text The label on the phone call button. Default: Call Now. You can change this to Call for a Free Estimate or similar.

API Configuration

LocalPages uses an AI model to write the content for each page. You need an API key from one of the supported providers.

AI Provider Select your preferred AI provider from the dropdown:

OpenAI — GPT models (most popular, good balance of quality and cost)

Anthropic (Claude) — Claude models (excellent writing quality)

Google (Gemini) — Gemini models

xAI (Grok) — Grok models

API Key (required) Paste your API key from the selected provider. The key field label and placeholder update automatically when you change the provider (e.g., OpenAI keys start with sk-..., Anthropic keys with sk-ant-...).

Important: Your API key is stored for a single generation run only and is automatically deleted once generation completes. You will need to re-enter it every time you generate pages. Keys are encrypted at rest and are never logged or shared.

Model Select the specific AI model to use. The dropdown updates automatically based on your chosen provider. Each provider offers fast/cheap, balanced, and highest-quality options. The recommended option is pre-selected for each provider. If you need a model not in the list, select Custom model name… and type the exact model ID in the field that appears.

Test Connection (button) Click this after entering your API key to verify it works before running a full generation. A status message appears next to the button confirming success or showing an error.

URL Structure

URL Base The prefix used in the URL for all generated location pages. Default: locations. With this setting, a page for Austin, TX would live at /locations/austin/.

URL Hierarchy Choose how URLs are structured:

Flat: /locations/city/ — simpler, works well for single-state businesses.

Nested: /locations/state/city/ — adds the state in the path, better for multi-state businesses.



Parent Page (optional) If you want location pages nested under an existing WordPress page, select it here. Useful if you have a "Service Areas" landing page and want location pages to be children of it in the WordPress hierarchy.

Saving

Save Setup (button) Saves all settings on this tab. A status message appears confirming the save. Always save before moving to the next tab.

Tab 2 — Locations

This is where you build your list of cities. You can add locations in three ways.

Bulk Add Locations

Paste locations (one per line) Type or paste a list of locations, one per line. Two formats are accepted:

City, State — example: Austin, TX

City, State, ZIP — example: Austin, TX, 78701

Parse & Add (button) Click after pasting your list. The plugin validates and parses each line and adds them to the locations table below. A status message shows how many were added successfully.

Import from CSV

Choose CSV File (button) Click to open a file picker and select a .csv file. The first row must be a header row with at minimum a City and State column. ZIP is optional. Example format:

City,State,ZIP

Austin,TX,78701

Dallas,TX

San Antonio,TX,78201

The plugin reads the file in-browser and adds all rows to the locations table automatically.

Add Individual Location

For adding one location at a time.

Custom Slug (optional) The URL slug to use for this location's page. If left blank, a slug is auto-generated from the city name (e.g., austin). Use a custom slug if you need something different, like austin-texas.

Add (button) Adds the location to the table.

Location Counter

Displays how many locations are currently in your list, e.g., 12 of 50 locations. The plugin supports up to 50 locations per batch.

Locations Table

Shows all locations currently in your list. Columns:

City — the city name

State — the state code

ZIP — ZIP code if provided

Slug — the URL slug that will be used

Image — shows a thumbnail if an image has been pre-assigned to this location

Status — whether a page has been generated for this location yet

Actions — a remove button to delete that location from the list

Locations Actions

Clear All Locations (button, shown in red) Removes every location from the list. Use with caution — this cannot be undone from this view.



Saving

Save Locations (button) Saves the current location list. Always save before moving to the Content or Generate tabs.

Tab 3 — Content

The Content tab controls what goes into the pages: which internal links to include, what images to use, and how the AI should write.

Pillar Pages

Search pages field Type to filter your existing WordPress pages. The list below updates as you type.

Page list (scrollable) Shows your WordPress pages. Click any page to select it as a pillar page. Selected pages are added to the Selected Pages list below.

Selected Pages list Shows the pages you have chosen. Each entry has a Remove button to deselect it. Choose 2–5 pages that you want every location page to link to — typically your main services pages, contact page, or about page. These links are woven into the generated content naturally.

Image Library

Select Images from Library (button) Opens the WordPress media library so you can choose images to rotate across your location pages. Select 5 or more images for best results. The plugin cycles through them so each location page gets a different image.

Images count Displays how many images are currently selected (e.g., 7 images selected). Images appear as thumbnails in the grid below the button.

Content Controls

Content Tone Sets the writing style the AI uses for all generated content. Options:

Professional — formal, authoritative language suitable for law firms, medical, and finance.

Friendly — approachable, conversational, good for home services.

Technical — detail-focused, good for engineering or IT services.

Casual — relaxed and informal, good for lifestyle businesses.

Include FAQ Section (checkbox) When checked, each location page will include a Frequently Asked Questions section with AI-generated questions and answers relevant to your service and city.

FAQ Questions per Page How many FAQ items to generate per page. Range: 3–6. Default: 4.

Include Trust Signals (checkbox) When checked, a trust signals section is added to each page highlighting your credentials and achievements.

Trust Signals A list of short, punchy statements that appear in the trust signals section. Examples: 500+ customers served, Licensed & insured since 2010, A+ BBB Rating. Click + Add Signal to add more rows. Each signal gets its own input field.

Include Service Area Section (checkbox) When checked, a section describing your coverage area is added to each page.

Additional Context A free-text field for any special instructions to pass to the AI. Use this for anything that doesn't fit the other fields. Examples: We only do residential, not commercial, We offer a senior discount, Our main competitor is [Brand], do not mention them.

Internal Links per Page How many links to other location pages to include in each generated page. Range: 3–6. This creates an internal linking network across all your location pages, which helps SEO.

Linking Strategy Controls which other location pages get linked from each page:

Geographic Proximity — links to the nearest cities geographically.

Alphabetical Neighbors — links to cities that are alphabetically adjacent in the list.

Random — links to random cities.

Saving

Save Content Settings (button) Saves all settings on this tab.



Tab 4 — Review

The Review tab is a pre-flight check before you run generation. It shows a summary of everything you've set up across the other three tabs — your business info, location count, content settings, and a validation checklist.

If any required fields are missing or there are configuration problems, they appear here as warnings. Fix them in the relevant tab and return to Review before generating.

There are no fields to fill in on this tab — it is read-only. The content is populated automatically from your saved settings.

You must complete the Setup, Locations, and Content tabs before the Review tab will show your summary.

Tab 5 — Generate

This is where you kick off the page generation run.

Pre-Generation Checklist

Before the Generate button becomes active, the plugin checks that the required steps are complete. Each item shows as either complete (✓) or incomplete (○):

Business information complete — all required Setup fields are filled in.

At least 1 location added — the Locations tab has at least one saved location.

API key validated — the API key has been tested and confirmed working.

Pillar pages selected (optional) — at least one pillar page has been chosen in Content.

No URL conflicts (optional) — no existing pages share the same URLs as pages that would be generated.

The Generate button stays disabled until the first three required items are checked off.

Generate Location Pages (button)

The main action button. Once all required checklist items are green, this button becomes active. Click it to begin generating pages. The plugin sends each location to the AI one at a time, builds the page, adds schema markup, wires in internal links, and publishes it to WordPress.

Do not close the browser tab during generation. The process runs in your browser and will stop if the tab is closed.

Progress Area

Appears automatically once generation starts.

Progress bar — shows how many pages have been completed out of the total. The percentage and count update in real time.

Currently generating — shows which city is being processed right now.

Step indicators — shows which step of the process is active for the current page:

Content generation

Schema markup

Page building

Internal links

Publishing

Last completed — the name of the most recently finished location.

Error / Warning counters — running tallies of any pages that encountered issues.

Time remaining — an estimate of how long the rest of the run will take.

Stop Generation (button, red) Stops the generation run after the current page finishes. Pages that were already completed remain published. Use this if something looks wrong or you need to stop mid-run.

Summary Area

Appears after generation finishes.

Pages created successfully — count of pages that generated without issues.

Pages generated with warnings — count of pages that completed but had minor issues (check the report for details).

Pages failed — count of pages that could not be generated. These locations remain available to retry.

Estimated API cost — shows the approximate cost of the generation run in dollars, along with the total token count used. This is an estimate based on your provider's current pricing.

View All Pages (button) — takes you to the WordPress page list filtered to show all pages.

View Generation Report (button) — opens a detailed log of the generation run, including any errors or warnings for individual pages.

For help editing individual location pages after they've been generated, see the Edit Pages Guide.