Troubleshooting

Pages return 404 (Not Found)

Common causes:

• You changed Base slug (Settings → General)
• WordPress rewrite rules need a refresh

Fix:

1. Go to Settings → Permalinks and click Save Changes
2. Or use PlaceScale → Tools → Flush rewrite rules

Placeholders are not replacing

Check:

• The placeholder key is spelled correctly: {service} not {serivce}
• You actually selected terms in Bulk Generate
• Your template doesn’t contain unknown placeholders

Tip: Use Bulk Generate → Preview to catch unresolved placeholders before generation.

Preview shows “Unknown or unresolved placeholders”

This means your template contains {something} that PlaceScale doesn’t have data for.

Fix:

• remove the placeholder, or
• add the missing term Custom Field, or
• adjust your term selection / term types

Bulk Generate is slow or times out

Try:

• lower Batch Size in PlaceScale → Settings → General
• generate in smaller selections (fewer terms per run)

Publishing Scheduler isn’t publishing

Check:

• PlaceScale → Settings → Publishing is enabled
• The queue isn’t paused (Tools → Publishing queue)
• WP‑Cron requires site traffic to run

Best practice:

• On production sites, configure a real server cron job to hit wp-cron.php

Social preview image is missing

Fix in this order:

1. Set Default social share image in PlaceScale → Settings → SEO
2. Optionally set og_image on your service terms (or locations)

AI connection fails

Check:

• Provider selection in Settings → AI
• API key saved under AI Connector
• Your host allows outbound HTTPS requests

Recommended steps:

1. Open PlaceScale → Settings → AI
2. Click Test connection
3. Click Refresh models

AI Slots aren’t generated

Common causes:

• AI is disabled
• Bulk generation AI slots is turned off

Fix:

• Enable AI in Settings → AI
• Enable Generate AI Slots during bulk generation if you want them generated at create-time
• Or use Generated Pages → Bulk Actions → Generate AI Slots to queue them later

Need more diagnostics?

• Check PlaceScale → Tools → Batch Logs (short-lived, expires in 24h)
• If you enabled Debug Mode, check wp-content/debug.log