Troubleshooting

Documentation Index

Fetch the complete documentation index at: https://docs.topify.ai/llms.txt

Use this file to discover all available pages before exploring further.

Common Topify.ai issues, what each symptom means for your data, and how to fix it. If you don’t see your issue here, email info@topify.ai. Each Guides page also has its own FAQ section for topic-specific questions.

​

Setting up a new project

​

My new project is stuck on “analyzing”

The first analysis after you create a project is the biggest one we run — we’re crawling your website, generating prompts, and asking multiple AI providers about your category. It can take several minutes, especially for larger sites. What to try, in order:

1. Wait 3–5 minutes. This is normal for most new projects.
2. Refresh the page. The progress bar reads from the server when the page loads, so a stale page may not reflect current progress.
3. Click Retry on the project page. If the status shows error, this resolves most transient failures (a slow AI provider, a one-off timeout).
4. Open your website in an incognito browser window. If your site doesn’t load there, our analyzer can’t reach it either.
5. Email support if it’s been stuck for more than 15 minutes — info@topify.ai, include your project name.

​

Topify could not generate prompts for my brand

Why this matters: prompts are the questions Topify asks AI assistants on your behalf. No prompts = nothing to track. If you ended up with very few or zero suggestions, here’s what’s likely going on. The usual cause is that we couldn’t read enough from your website to understand what you actually do. The most common reasons:

• Your site blocks bots. Many sites block crawlers in robots.txt, by user-agent, or via Cloudflare/WAF rules. If we can’t read your site, we have nothing to base prompts on. (Same problem affects whether AI assistants can read you in the first place — fixing this often improves your AI visibility too.)
• Your homepage renders entirely with JavaScript. If the page is blank until JS runs, a basic crawl returns nothing useful.
• Your site is behind a login or paywall. Anything that requires authentication is invisible to us.
• Your brand name is too generic. If the brand name matches a common word, we can’t tell what it refers to.
• The website URL is wrong or redirects elsewhere. Double-check the URL in project settings.

What to do:

• Allow our crawler in robots.txt and any WAF/Cloudflare rules. We identify as a standard web client.
• For JS-heavy sites, make sure the key pages have meaningful server-rendered HTML (titles, descriptions, product copy).
• Add a few custom prompts manually from Tracking > Prompts > + Add Prompts. Once we have a few real examples of what you care about, suggested prompts work much better.
• Edit your project’s brand description in settings to give us more context about what you do.

​

Setup finished but no AI responses were collected yet

Different from the situation above — here, prompts exist but the per-prompt response counts are 0. That means we have a tracking plan but haven’t actually heard back from the AI providers yet. Likely causes and fixes:

• All providers timed out on the first run. AI providers occasionally rate-limit or go down. The next daily run will retry automatically, or click Retry on a prompt to re-fetch.
• The prompt got filtered. Some providers refuse certain queries (medical advice, legal advice, adult content). Rewrite the prompt to be more neutral.
• You haven’t activated any prompts yet. Suggested prompts aren’t tracked. Switch to the Active tab and confirm at least one prompt is there.

​

Content generation

​

Article generation failed

What it means: a step in the writing pipeline (research → outline → draft → SEO) didn’t complete, so no article was produced. The good news is failed generations don’t use a credit — you can retry without cost. Step-by-step diagnosis: To retry, open the failed task and click Regenerate, or create a new task with the same inputs.

​

Article was generated but quality is poor

Quality issues almost always come from thin input rather than the model itself. The richer the brief, the better the article. Things to add:

• A specific angle. “Write about CRMs” produces a generic article. “Compare HubSpot and Pipedrive for early-stage SaaS startups, focusing on contact enrichment” produces something a real buyer would read.
• Real reference URLs. We pull these into the writer’s context so the article can quote and cite them — citations are one of the things that makes AI assistants more likely to reuse your content.
• Up to 10 keywords. This is what the SEO step optimizes around. Leaving them blank weakens the metadata.

See Tutorial: Generate articles for more.

​

Dashboard and metrics

​

Dashboard shows no data after setup finished

Don’t panic — usually it’s a filter issue, not a missing-data issue.

1. Check the date range. The default is the last 7 days. A project created today only has data for today — make sure today is included.
2. Clear provider and topic filters. A filter set to a provider or topic with no data hides everything.
3. Confirm setup actually finished. Look at the project status. If it’s still processing, metrics will populate as it completes.
4. Wait for the first daily run. The initial setup collects a starter batch. The full daily collection happens once every 24 hours, so a project bootstrapped late at night may look thin until the next day.

​

Visibility, sentiment, or position is showing as 0

A 0 here means no data, not “your brand is doing badly.” Specifically:

• Visibility 0% — your brand wasn’t mentioned in any responses for this period. Either too little data yet, or the prompts you’re tracking don’t actually surface your brand.
• Sentiment 0 — your brand wasn’t mentioned, so there was nothing to score. (Sentiment runs 0–100; a real “negative” score sits in the 30–50 range.)
• Position 0 — same reason: no mention means no place in the response to measure.

If you’re seeing zeroes across the board, the action is to widen the date range first, then look at whether your prompts are actually the questions buyers ask in your category. Sometimes the prompts need editing, not the brand.

​

My numbers aren’t moving day-over-day

A few things to confirm:

• The initial setup is complete (not still processing).
• At least one prompt is on the Active tab. Suggested and inactive prompts aren’t collected.
• The date range includes today.
• Some metrics (competitor rankings, source aggregations) recompute after the daily collection cycle finishes — if you check very early in the morning, today’s numbers may not be in yet.

​

Team and access

​

Team invite email never arrived

1. Check spam/junk — most missing invites end up there.
2. Verify the email address on the members page is correct.
3. Invite codes expire after 10 minutes. Re-send if more time has passed.
4. If the person already has a Topify account with that email, they’re added automatically — no invite code needed, just sign in.

​

”Usage limit exceeded”

You’ve hit one of your plan’s limits. Check Management > Subscription for current usage. For limit definitions and how credits accumulate, see Billing and plans.

​

Cannot add more competitors

You’ve hit your plan’s competitor limit. Either remove competitors you no longer need from Preferences > Competitors, or upgrade. See Billing and plans.

​

Integrations

​

Search Console not showing data

• Make sure you authorized the correct Google account during OAuth — the one that owns the property.
• We can only see properties that account has at least Read access to.
• Data may take a few minutes to appear after the first sync.

​

CMS publish failed

• WordPress / Shopify / Framer: confirm the API key or OAuth connection is still valid in Platform > Integrations. Tokens can expire or be revoked.
• Confirm the publishing user has permission to create posts on the target site.
• For WordPress, check that the REST API is enabled and not blocked by a security plugin.

​

Still need help?

Contact us at info@topify.ai with:

• Your project name and the approximate time the issue happened
• A screenshot of any error message
• What you were trying to do, and what you expected to see instead

We typically respond within one business day.