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?
- Disconnect and reconnect Slack
- Check Slack app permissions
- Email support@withcircuit.com
CSV Import Errors
"Invalid CSV format"
- File needs
.csvextension - 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:
- Upgrade to a higher plan
- 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.