This article covers Topical Maps, content planning, competitor gap analysis, topic clusters, content briefs, custom topics, saved maps, and Content Velocity reporting inside Search Atlas.
⚠️ Error 1: Topical Map is stuck on "Generating" for more than 30 minutes
What's happening
Competitor analysis and keyword gap analysis (DKN) run as asynchronous background jobs.
Network interruptions, provider delays, or queue congestion can cause the generation task to stall.
This is more common when:
- analyzing very large domains
- using broad seed topics
- or generating multiple maps simultaneously.
Steps to try
-
Go to:
Left Sidebar → Local → Local SEO Tools →Topical Maps -
Locate the generation job stuck in:
"Generating"/"Fetching data" -
Click Delete/Cancel on the stuck task
-
Start a new generation:
- this will NOT delete existing maps
- only the failed job is replaced
-
Reduce the scope temporarily:
- use fewer competitors
- or a narrower seed topic
-
Avoid running multiple Topical Maps simultaneously for the same domain
-
Wait 2 hours if the task remains frozen:
- stalled jobs automatically time out and retry
-
Hard-refresh the dashboard after retrying:
- Ctrl + Shift + R
- Cmd + Shift + R
-
Check:
Left Sidebar → Content → Topical Maps
for duplicate stuck processes -
Contact support if:
- every generation attempt stalls repeatedly
- or generation never completes after multiple retries
Important Notes
- DKN jobs are resource-intensive
- large topical maps may legitimately require extended processing time
- canceling a stuck job does not delete completed maps
⚠️ Error 2: Topical Map generated but clusters are missing or empty
What's happening
The AI cluster generation engine occasionally returns malformed or incomplete cluster data that cannot be parsed correctly.
This can cause:
- empty topic groups
- blank keyword clusters
- or partially generated maps.
Steps to try
-
Open the affected Topical Map
-
Identify:
- empty clusters
- incomplete topic groups
- or blank sections
-
Click Regenerate Clusters on the affected section
-
Wait several minutes for the cluster rebuild to complete
-
Refresh the map after regeneration
-
If multiple clusters are empty:
- delete the map
- regenerate from scratch
-
Narrow the seed keyword:
- overly broad topics increase malformed cluster probability
-
Avoid running simultaneous cluster regenerations
-
Test with a smaller competitor set temporarily
-
Contact support if:
- regenerated clusters continue returning empty
- or the same map repeatedly fails parsing
Important Notes
- cluster generation depends on AI parsing pipelines
- broad generic keywords produce lower-quality cluster separation
⚠️ Error 3: Competitor domains not showing up in the gap analysis
What's happening
Competitor intelligence data is pulled from external SEO research providers.
Very small, new, or low-authority domains:
- may not exist in the provider database yet
- or may have insufficient crawl coverage.
Steps to try
-
Verify the competitor domain is publicly accessible
-
Confirm the domain:
- ranks in Google
- has indexed pages
- and has backlink activity
-
Try larger competitors in your niche first
-
Use competitor domains with:
- 500+ referring domains
- or established organic visibility
-
Avoid testing with:
- new domains
- staging sites
- or low-traffic microsites
-
Run:
Left Sidebar → Site Metrics → Competitors
separately to confirm the competitor has provider coverage -
Refresh the gap analysis after changing competitors
-
Reduce the number of competitors in the request
-
Retry during off-peak hours
-
Contact support if:
- major well-known competitors never appear
- or all competitor analysis remains blank
Important Notes
- competitor visibility depends on external provider coverage
- provider databases refresh independently from Search Atlas
⚠️ Error 4: "Cannot create analysis" error when starting a new Topical Map
What's happening
A duplicate or active DKN generation task already exists for the same domain.
The system blocks overlapping analysis jobs to:
- prevent queue conflicts
- avoid duplicate processing
- and reduce malformed outputs.
Steps to try
-
Go to:
Left Sidebar → Content→ Topical Maps → Check Active Jobs -
Look for:
- pending jobs
- stuck jobs
- or active generations
-
Wait for active jobs to complete
-
Cancel frozen or duplicate jobs
-
Refresh the page after cancellation
-
Retry generation after several minutes
-
Avoid opening multiple generation tabs simultaneously
-
Confirm another team member is not already running the same analysis
-
Reduce the scope of the request temporarily
-
Contact support if:
- no active jobs exist
- but generation still fails immediately
Important Notes
- duplicate protection is intentional system behavior
- background jobs may require several minutes to clear after cancellation
⚠️ Error 5: Content brief generated from a topical cluster is off-topic
What's happening
The content brief inherits context from the cluster seed keyword.
If the seed keyword is:
- too broad
- ambiguous
- or low-intent
…the generated brief may become generic or partially irrelevant.
Steps to try
-
Edit the cluster's primary keyword
-
Make the keyword:
- more specific
- more localized
- or more intent-driven
-
Add:
- target audience
- industry
- or content angle
-
Use:
Refine Brief
before regenerating -
Avoid generic seed terms like:
- "marketing"
- "SEO"
- "software"
-
Use long-tail intent-focused keywords instead
-
Regenerate the brief after refining
-
Compare competitor examples manually
-
Add custom subtopics if important context is missing
-
Contact support if:
- all briefs consistently generate irrelevant outputs
Important Notes
- brief quality depends heavily on keyword specificity
- AI-generated briefs should be treated as strategic first drafts
⚠️ Error 6: Topical Map not including keywords I know are important
What's happening
Automated keyword discovery prioritizes:
- provider data
- competitor overlap
- and detected search demand.
Very niche or long-tail keywords may not be discovered automatically.
Steps to try
- Use:
Add Custom Topic
inside the map - Manually create missing keyword clusters
- Run:
Left Sidebar → Keyword → Keywords Research
separately for the missing terms - Import discovered keywords into the map manually
- Expand competitor selection
- Add more seed keywords before regeneration
- Use localized variations of important terms
- Include question-based queries and FAQs
- Regenerate cluster relationships after additions
- Contact support if:
- large obvious keywords never appear in discovery
Important Notes
- no automated keyword discovery system captures 100% of long-tail search behavior
- manual augmentation is expected for advanced SEO workflows
⚠️ Error 7: Saved Topical Map is no longer visible in the list
What's happening
Topical Maps are attached to the project where they were created.
If the project:
- was archived
- deleted
- disconnected
- or moved
…the associated map may disappear from the visible list.
Steps to try
- Check whether the project was deleted accidentally
- Restore the archived project if possible
- Refresh the Topical Maps dashboard
- Confirm you are inside the correct workspace
- Verify another team member did not rename or move the project
- Check filters inside the Topical Maps list
- Log out and back in to refresh permissions
- Search for the map by project/domain name
- Contact support if:
- the project exists
- but maps remain permanently missing
Important Notes
- restoring a project restores associated Topical Maps
- workspace permissions affect map visibility
⚠️ Error 8: Content Velocity chart shows no data
What's happening
Content Velocity is a Beta reporting feature that requires enough publishing history before meaningful trends can be generated.
Steps to try
-
Confirm your account has at least 30 days of publication history
-
Verify content was published through:
- OTTO
- Website Studio
- or tracked publishing systems
-
Refresh the reporting dashboard
-
Expand the date range
-
Confirm the correct project is selected
-
Verify content tracking is enabled for the project
-
Wait for the next reporting cycle
-
Continue publishing content consistently
-
Avoid expecting meaningful trends from very small datasets
-
Contact support if:
- the chart remains empty after 45+ days
- or previously visible data disappears unexpectedly
Important Notes
- Content Velocity is still evolving as a Beta feature
- trend analysis improves with larger publishing history datasets
Most Topical Maps & Content Planning issues are not caused by broken Search Atlas functionality.
They are usually related to:
- asynchronous DKN processing
- AI clustering behavior
- competitor data limitations
- broad seed topics
- duplicate background jobs
- or insufficient content history.
Because Topical Maps combine AI generation, SEO intelligence, and semantic clustering systems, some delays or incomplete outputs are expected during large-scale analysis operations.
👉 The best Topical Maps results come from:
- highly specific seed topics
- strong competitor selection
- narrow semantic intent
- clean project organization
- and allowing background analysis jobs enough time to complete