> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adstellar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues

> Solutions to frequently encountered problems in AdStellar.

## Meta Connection Issues

### Token Expired

Meta OAuth tokens expire periodically. If you see connection errors:

1. Go to **Settings > Integrations**.
2. Click **Resync Meta** to refresh your token.
3. If resync fails, click **Disconnect** and reconnect your Meta account.

### Ad Account Not Appearing

If an ad account doesn't show up after connecting Meta:

* Verify you have **admin access** to the ad account in [Meta Business Manager](https://business.facebook.com).
* Click **Resync Meta** to re-fetch the account list.
* Check that the ad account isn't disabled or restricted in Meta.

### Connection Health Banner

A yellow banner appears in the app when your Meta connection needs attention. Click the banner to go to the Integrations page and resolve the issue.

## Campaign Launch Issues

### Validation Errors on Review

The Review step checks your campaign for issues before publishing:

* **Errors** (red) must be fixed before you can publish. Click "Go fix this" to jump to the relevant step.
* **Warnings** (yellow) are informational and won't block publishing.

Common errors include missing Facebook Page, invalid targeting for special ad categories, and budget below Meta's minimum.

### Campaign Stuck in "Publishing"

Campaign publishing runs as a background job. If it seems stuck:

1. Check the **Launches** tab on the Campaigns page for status updates.
2. Wait a few minutes -- large campaigns with many ad variations take longer.
3. If the status shows "Failed," expand the launch card to see error details.

## AI Features

### AI Builder Not Available

The AI Builder is included on every plan. If it's unavailable, make sure your subscription is active and you have enough AI credits — check your **workspace menu (top-left) → Billing & Subscription**.

### "Not Enough Data" for AI Features

AI Insights, Proven Winners, and AI Combos require performance data. To populate data:

1. [Import existing campaigns](/getting-started/import-campaigns) from Meta.
2. Wait for campaigns to accumulate spend and conversion data.
3. AI features typically need at least 7 days of active campaign data.

## Billing

### Payment Failed

If your payment fails, a modal will prompt you to update your payment method:

1. Click **Update Payment Method** in the modal.
2. You'll be redirected to the Stripe customer portal.
3. Add a new card or update your existing payment details.

### AI Credits Depleted

When your AI credits are used up:

* **Move to a higher credit volume** -- open your **workspace menu (top-left) → Billing & Subscription → Change Plan** for more monthly credits.
* **Wait for your next grant** -- Credits are granted monthly on your billing anniversary and expire after 60 days.

## Still Need Help?

* **In-app chat** -- Click the support icon inside AdStellar.
* **Email** -- Contact [support@adstellar.ai](mailto:support@adstellar.ai).