Troubleshooting Guide Index

Complete troubleshooting documentation for Brande.ai users. Each guide covers common error states, causes, and direct solutions.

Quick Links

1. Brand Voice Analysis Failures

   • "Brand Analysis Failed" error
   • "Start Analysis Failed" message
   • "Missing URL" error
   • Analysis timeout issues

2. Content Generation Errors

   • "An Error Occurred" or "Oops!" message
   • API errors during generation
   • Empty or gibberish results
   • Generation timeouts

3. File Upload Problems

   • "File Size Limit Exceeded"
   • "File Type Not Supported"
   • "File Delete Error" / Failed deletion
   • Files upload but aren't analyzed

4. Premium Feature Access

   • "Premium Feature" modal
   • "Upgrade Your Plan" message
   • Trial period restrictions
   • Collaborator limit exceeded
   • Plan comparison and upgrades

5. Content Agent Not Working

   • "Error Loading Recommendations"
   • "No Recommendations Available"
   • "Something Went Wrong" errors
   • Agent disabled or grayed out

6. Publishing and Integration Errors

   • Failed publish status
   • Expired integrations
   • Revoked integrations
   • Account selection issues
   • OAuth and token problems

7. Account and Login Issues

   • "Invalid Email" validation
   • "Password Must Match" error
   • Password reset not arriving
   • Invalid reset tokens
   • Account locked messages

How to Use This Guide

Each troubleshooting document follows this structure:

1. Error Title — The exact error message or issue
2. Direct Answer — The root cause in one sentence
3. How to Fix This — Step-by-step solutions (numbered)
4. If This Doesn't Work — Escalation steps and support contact

Support Resources

• In-app help — Click the ? icon in any feature for context-specific help
• Email support — support@brande.ai (response within 24 hours)
• Documentation — Full feature docs available in Account Settings
• Status page — Check platform status at status.brande.ai

Common Issues by Category

API and Generation (Most Common)

• Brand DNA is incomplete or too vague
• Request exceeds size/complexity limits
• Temporary server load during peak hours
• Network timeouts

Authentication and Access

• Email/password validation errors
• Password reset emails in spam folder
• Token expiration after 90 days
• Account locked after failed attempts

File Handling

• Files exceed 25MB size limit
• Unsupported file formats (only PDF, DOCX, TXT, CSV)
• Uploads complete but analysis doesn't start
• Permission issues prevent deletion

Subscription and Features

• Plan doesn't include requested feature
• Trial period has restrictions
• Collaborator slots are full
• API credits exhausted

Getting Help

If you've tried all troubleshooting steps:

1. Gather information

   • Error message (exact text)
   • What you were trying to do
   • When it started happening
   • Any recent account changes

2. Contact support

   • Email: support@brande.ai
   • Include error message and steps you've tried
   • Attach screenshot if helpful

3. Account issues

   • For security issues (password reset, locked account)