Stuck? Start here.

High queue volume or large asset resolution.

1. Check the status bar for queue position.
2. Switch to Standard quality for faster output.
3. Try again during off-peak hours (before 9 AM or after 8 PM UTC).

Input images lack contrast or the prompt is too vague.

1. Upload a higher-resolution product photo (1200px minimum).
2. Add 2-3 specific adjectives to your prompt (e.g. "warm lighting, lifestyle context").
3. Regenerate with the "HD" toggle enabled.

Brand DNA profile is outdated or incomplete.

1. Go to Settings > Brand DNA and re-scan your website URL.
2. Confirm the color palette and font selections match your current brand.
3. Regenerate the asset after saving changes.

Platform preset does not match your intended output.

1. Open the generation panel and select the correct platform (e.g. Instagram Story = 9:16).
2. If using custom dimensions, enter them in the "Custom size" field.
3. Regenerate with the corrected ratio.

Temporary server error or content policy trigger.

1. Wait 30 seconds and retry.
2. Review your prompt for flagged terms (profanity, trademarked names).
3. If the error persists, contact support with the generation ID from the error toast.

You have used all credits for the current billing cycle.

1. Check usage at Settings > Billing > Current usage.
2. Upgrade your plan for additional credits.
3. Wait until your cycle resets (shown on the billing page).

Wrong email address or expired session token.

1. Confirm you are using the same email you signed up with.
2. Clear your browser cookies for maniai.com.
3. Try the "Forgot password" flow to reset credentials.

No active password on file or social-only account.

1. Go to /forgot-password and enter your email.
2. Check spam/junk if the reset email does not arrive within 2 minutes.
3. If you signed up with Google, use "Sign in with Google" instead.

Account registered under a different address.

1. Check your inbox history for the original welcome email from mani.
2. Try logging in with your work email and personal email separately.
3. Contact support if you need to merge accounts.

Authenticator app removed or phone replaced.

1. Use one of your backup codes (provided at 2FA setup).
2. If you have no backup codes, email support@maniai.com from your registered email.
3. Support will verify identity and disable 2FA within 24 hours.

Emails caught by spam filter or corporate firewall.

1. Check your spam/junk folder.
2. Add noreply@maniai.com to your contacts or allowlist.
3. If using a corporate email, ask IT to whitelist maniai.com.

Too many failed login attempts triggered a security lock.

1. Wait 15 minutes for the automatic unlock.
2. Reset your password via /forgot-password.
3. Contact support if the lock persists after a successful password reset.

Insufficient funds, expired card, or bank security block.

1. Verify the card has not expired and has available balance.
2. Try a different payment method at Settings > Billing > Payment methods.
3. Contact your bank to authorize charges from "ManiAI" if they flagged the transaction.

Annual renewal, add-on, or team seat auto-upgrade.

1. Review your invoice at Settings > Billing > Invoices.
2. Compare the amount to your plan details (shown on the same page).
3. If the charge is incorrect, email billing@maniai.com with your invoice number.

Invoice not automatically sent to your email.

1. Go to Settings > Billing > Invoices.
2. Click "Download PDF" next to the relevant charge.
3. To add a VAT number or company address, update Billing Details before downloading.

Current usage exceeds the lower tier limits.

1. Go to Settings > Billing > Change plan.
2. Select the target tier and confirm.
3. The downgrade takes effect at the end of your current billing cycle.

You want to stop all future charges.

1. Go to Settings > Billing > Change plan.
2. Click "Cancel subscription" at the bottom.
3. Your access continues until the current period ends, then reverts to the free tier.

Charge within the 14-day refund window.

1. Email billing@maniai.com with your invoice number and reason.
2. Refunds are processed within 5-7 business days if within the 14-day window.
3. Charges older than 14 days are not eligible for refund per our terms.

API key expired or list mapping misconfigured.

1. Go to Settings > Integrations > Klaviyo.
2. Re-enter your Klaviyo private API key (generate a new one at klaviyo.com/account#api-keys).
3. Re-map your audience list and click "Test connection".

Ad account permissions revoked or token expired.

1. Go to Settings > Integrations > Meta.
2. Click "Reconnect" to reauthorize your Facebook Business account.
3. Ensure the connected ad account has "Advertiser" role or higher.

Endpoint URL unreachable or returning non-2xx.

1. Verify your endpoint URL is publicly accessible (not localhost).
2. Check Settings > Integrations > Webhooks for delivery logs and error codes.
3. Update the URL and click "Send test" to confirm delivery.

Key copied with extra whitespace or scoped incorrectly.

1. Re-copy the key from Settings > API (use the copy button, not manual selection).
2. Confirm the key scope matches your use case (read vs. read-write).
3. Regenerate the key if the issue persists.

TikTok OAuth token expired after 24 hours of inactivity.

1. Go to Settings > Integrations > TikTok.
2. Click "Reconnect" and complete the TikTok login flow.
3. Re-select your advertiser account from the dropdown.

Zap turned off due to repeated trigger failures.

1. Open your Zap in Zapier and check the task history for errors.
2. Reconnect the ManiAI connection in Zapier (My Apps > ManiAI > Reconnect).
3. Turn the Zap back on and trigger a test event from mani.

Seat limit reached on your current plan.

1. Check your seat count at Settings > Team > Members.
2. Upgrade to a plan with more seats, or remove an inactive member.
3. Retry the invite after freeing a seat.

Approval workflow not assigned to the correct reviewer.

1. Go to Settings > Team > Approval workflows.
2. Verify the reviewer email matches an active team member.
3. Save changes and re-submit the asset for approval.

Commenting on a different asset version or workspace.

1. Confirm you are viewing the latest version of the asset (check the version dropdown).
2. Switch to the correct workspace if you belong to multiple teams.
3. Refresh the page to load new comments.

Role assignment does not match intended access level.

1. Go to Settings > Team > Members.
2. Click the member name and update their role (Viewer, Editor, Admin).
3. The change takes effect immediately on their next page load.

Browser session cached to a different workspace.

1. Click the workspace switcher in the top-left corner of the dashboard.
2. Select the target workspace from the dropdown.
3. If the workspace is missing, accept the pending invite in your email.

Team invites expire after 7 days.

1. Go to Settings > Team > Pending invites.
2. Click "Resend" next to the expired invite.
3. Ask the invitee to accept within 7 days of the new email.