Common Issues

Troubleshooting·
4 min read

Common Issues

Quick fixes for common problems.


Slack Not Syncing

Check connection status: Go to Settings → Integrations → Slack. Should show "Connected".

Check selected channels: Make sure at least one channel is selected.

Check timing: Circuit polls every 10 minutes. New messages may take up to 10 minutes to appear.

What gets filtered out:

  • Bot messages
  • Already-imported messages
  • Messages from before your connection date

Still not working?

  1. Disconnect and reconnect Slack
  2. Check Slack app permissions
  3. Email support@withcircuit.com

CSV Import Errors

"Invalid CSV format"

  • File needs .csv extension
  • Use comma separation (not semicolons)
  • UTF-8 encoding
  • Include a header row

"Column not found" We look for: feedback, text, message, content for feedback text. Use the column mapper if your columns are named differently.

"Duplicate entries skipped" This is intentional - we deduplicate by text hash to prevent importing the same feedback twice.

Large files (10,000+ rows)

  • Import may take several minutes
  • Progress bar shows status
  • Split into files under 10,000 rows for reliability

Widget Not Appearing

Check embed code: Make sure the script tag is in your HTML, preferably before </body>.

Check API key: Verify the API key in the embed code matches your widget settings.

Check CORS: Widget works from any domain. No CORS configuration needed.

Check console: Open browser dev tools (F12) and look for errors in Console tab.


Brief Not Generating

No feedback? Briefs need feedback items. Import some first.

GitHub not connected? The "Files to Touch" section requires GitHub connection. Connect at Settings → Integrations → GitHub.

Empty brief? Try clicking Refresh. If still empty, the priority needs more feedback to generate a useful spec.


Priorities Not Updating

Check for new feedback: Priorities update when new feedback is imported and grouped.

Trigger reprocessing: New feedback is processed automatically. Allow a few minutes for processing to complete.

Check processing status: If feedback shows as "processing", wait for it to complete.


MCP Authentication Issues

"Not authenticated" Delete ~/.circuit/token.json and re-run. A browser will open for OAuth.

"MCP not found" (Cursor) Check ~/.cursor/mcp.json configuration:

{
  "mcpServers": {
    "circuit": {
      "command": "npx",
      "args": ["circuit-mcp"]
    }
  }
}

"MCP not found" (Claude Code) Run: claude mcp add circuit -- npx circuit-mcp


Search Not Finding Results

Minimum query length: 2 characters required.

Try synonyms: Search is semantic. "slow" finds "performance", "latency", "loading".

No results?

  • Check you have feedback/priorities in the system
  • Try broader search terms
  • Use ⌘K / Ctrl+K from anywhere for global search

Usage Limit Errors

At your limit? Check current usage at Settings → Billing.

Options:

  1. Upgrade to a higher plan
  2. Wait for next billing cycle (limits reset monthly)

Processing Takes Too Long

Normal processing times:

  • Feedback classification: 1-2 seconds per item
  • Clustering: 5-30 seconds depending on volume
  • Brief generation: 5-15 seconds

Large imports: Imports over 1,000 items may take several minutes. Progress is shown.


Team Invite Not Arriving

Check the email address: Verify spelling. Invites are case-insensitive but must be a valid address.

Check spam/junk folder: Invite emails come from Circuit. Check spam filters.

Seat limit reached? Each plan has a seat limit (2 on Starter, 5 on Pro, 10 on Max). If the limit is reached, new invites are blocked. Upgrade at Settings → Billing.

Invite expired? Invites expire after 7 days. Send a new one from Settings → Team.


Undo CSV Import Not Working

Only the most recent CSV upload can be undone. Undo is available from the completion screen after a CSV upload. It does not apply to Google Sheets or manual entry imports.

Already uploaded another CSV? A new upload replaces the undo target. Only the most recent CSV upload is reversible.

Left the completion screen? Undo is available on the completion screen immediately after upload. If you navigate away, the undo option is no longer available.


Classification Correction Not Applying

Give it a moment. Corrections apply to future feedback on the same theme. Existing feedback on other priorities is not reclassified.

Same theme, different wording? If new feedback uses very different language, it may not match the corrected theme. Correct again and Circuit learns the broader pattern.


Still stuck?

Email support@withcircuit.com with:

  • What you were trying to do
  • What happened instead
  • Screenshots if helpful
  • Browser and device info

We respond within 24 hours.

Can't find what you're looking for?

Contact support