Skip to main content
This guide focuses on issues customers are most likely to hit while using the product.

​
A connector will not connect

Check the following:
  1. The connector type matches the source you are trying to connect.
  2. The connection details were entered exactly as required.
  3. You ran the connection test before saving.
  4. The remote system is reachable from your environment.
If the connector still fails, edit it, test again, and confirm that the endpoint or credentials have not changed. For HubSpot, try re-authorizing from the catalog sync page if OAuth expired.

​
Chat answers are empty or not useful

Try this sequence:
  1. Confirm the correct connector is selected in chat.
  2. Disable unrelated connectors if the question should use only one source.
  3. Ask a narrower question with a time range or business segment.
  4. If the connector supports indexing, confirm indexing has completed.
  5. Review connector memory for incorrect learnings and reject or delete bad entries.
  6. Run evaluation to identify failing golden cases.

​
Follow-up suggestions are missing

Follow-up suggestions only appear when Vizkraft has a completed answer to build from. If they do not appear:
  1. Wait for the current answer to finish.
  2. Refresh the chat session if the connection briefly dropped.
  3. Ask the next question manually in the same thread.

​
Memory is not updating or looks wrong

If memory notifications never appear or saved entries seem incorrect:
  1. Confirm you are using the connector that should be learning.
  2. Reject incorrect entries from the chat notification or the memory panel immediately.
  3. Pin critical definitions so they are not replaced when memory is full (50 entries per connector).
  4. Add correct entries manually from the memory panel if Vizkraft missed an important definition.

​
Evaluation will not run

If the Run evaluation button is disabled or fails:
  1. Confirm the connector is a SQL or MongoDB source — evaluation is not available for HubSpot or custom MCP connectors.
  2. Open the Learnings tab and approve at least five golden cases.
  3. Wait for question generation to finish if the dataset is still being built.
  4. Use thumbs up in chat to promote real answers into golden cases faster.

​
Charts are not appearing

If a chart is not generated:
  1. Make sure the answer returned data instead of an empty result.
  2. Ask for a metric and a dimension, such as revenue by month.
  3. Try a simpler question or ask explicitly for a chart.

​
A chart will not save or edit correctly

Check the following:
  1. The chart has a clear title.
  2. The chart result contains usable data.
  3. You still have access to the connector or underlying data source if the chart is live-backed.
If a chart looks outdated, open it in the chart editor and refresh the data if that option is available. Try the Ask AI bar for quick formatting changes.

​
I cannot re-index a connector or add a new one

If you see an error like Indexing quota exhausted for this billing cycle:
  1. You have used all of your monthly indexing runs for the current cycle.
  2. The counter resets automatically at the start of your next billing cycle, on the same date your subscription credits renew.
  3. To check your remaining runs and reset date, open Profile → Usage and look at the Indexing runs tile.
  4. To get a higher allowance immediately, upgrade from Profile → Billing → Plans (Pro 5/mo, Business 20/mo, Enterprise unlimited).
Existing connectors keep working normally during this time — you just cannot trigger a new indexing run until the cycle resets or you upgrade. See Indexing runs and your plan for the full breakdown.

​
HubSpot catalog sync failed

If HubSpot sync does not complete:
  1. Re-authorize HubSpot from the catalog sync page.
  2. Confirm your HubSpot account still has the scopes Vizkraft needs.
  3. Use Re-sync after authorization succeeds.
  4. Check that the connector was not deleted between OAuth steps.
See HubSpot CRM sync for the full connect flow.

​
Suggested charts or dashboards are not visible

Suggestions usually depend on connector analysis. Verify that:
  1. The connector was saved successfully.
  2. Indexing or catalog sync completed.
  3. Important tables were selected if your schema is large.
  4. Enough time has passed for suggestions to be generated (watch for the generating state).
  5. You refreshed the Charts or Dashboards page after indexing.

​
AI filter did not parse my request

If the AI filter returns no filters or an unexpected result:
  1. Be specific about the column, time range, or segment you want.
  2. Check that the dashboard has charts backed by the connector you are filtering.
  3. Clear AI filters and try again with a shorter query.
  4. Fall back to manual filters if the column you need is not indexed yet.

​
Smart filters are empty

If no smart filter badges appear:
  1. Confirm the dashboard has saved charts with filterable columns.
  2. Use Regenerate smart filters after adding or removing charts.
  3. Check whether all suggested filters are already applied — applied filters are hidden from the list.

​
Dashboard filters are not affecting the charts you expected

Try these checks:
  1. Confirm the filter was applied from the current dashboard.
  2. Review whether the target charts use the same connector and relevant fields.
  3. Save a fresh view after changing filters if you want the state to persist.

​
Dashboard layout changes are not where you expect them

If the layout feels off:
  1. Drag the chart again and wait for the page to settle.
  2. Resize the chart so important visuals have enough space.
  3. Refresh the dashboard and confirm the latest layout loaded.

​
Slack is connected but using the wrong source

Open Preferences and review the default Slack connector. If multiple connectors exist, set the one you want Vizkraft to use when a Slack message does not explicitly name a source.

​
When to contact support

Contact support if:
  • A connector repeatedly fails after the details were rechecked.
  • Indexing or HubSpot sync never completes.
  • Suggestions do not appear even after analysis has finished and the page was refreshed.
  • Dashboard exports fail consistently.
  • Evaluation runs fail repeatedly after golden cases are approved.
Send support:
  • The connector name
  • The page where the issue happened
  • The exact action you took
  • Any visible error message or screenshot