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

# Troubleshooting

> Common issues and how to resolve them.

## Signals

### "Why isn't my signal firing?"

If you've activated a signal but aren't seeing results in your feed:

1. **Check your ICP configuration:** signals only surface accounts that match your ICP. If your ICP is too narrow, fewer accounts qualify. Review your settings in **Settings > ICP & Personas**.
2. **Wait for processing:** after activation, signals can take up to a few hours to start appearing. The preview during setup skips ICP grading for speed, but your live feed applies full scoring.
3. **Verify your filters:** overly restrictive filters (e.g., very specific job titles or niche industries) can reduce signal volume to near zero. Try broadening your filters and re-previewing.
4. **Check credit balance:** if your workspace has exhausted its monthly credits, new signals are queued but not delivered. Check **Settings > Plan & Usage**.

### "Why do I see signals in preview but not in my feed?"

The preview skips time-consuming steps like ICP grading and deduplication to give you a quick sense of signal breadth. Your live feed applies full scoring, which may filter out accounts that don't meet your ICP threshold.

### "My signal is showing duplicate accounts"

Avina deduplicates signals by account. If you're seeing what appears to be duplicates, they may be:

* Different signal types from the same account (e.g., a web visit AND a new hire at the same company)
* Signals from different time periods that are both still active in your feed

Use the **Resolve** action to clear signals you've already acted on.

***

## Web SDK

### "SDK is installed but I'm not seeing web visit signals"

1. **Check domain registration:** your website domain must be registered in **Settings > Web Tracking**. Traffic from unregistered domains is silently dropped. See [Domain Validation](/sdk-reference/domain-validation).
2. **Verify the script is loading:** open your browser's developer console and check for the `mesh-analytics-sdk` script. Ensure it loads without errors.
3. **Check your SDK key:** the script must include your workspace's SDK key. Find it in **Settings > SDK**.
4. **Confirm tracking settings:** if `track: { session: false }` is set, session data won't be captured. See [SDK Configuration](/sdk-reference/configuration).

### "Form fills aren't being tracked"

Ensure `track: { forms: true }` is set in your SDK configuration. If your forms are embedded in iframes, add the SDK to the iframe page with `track: { session: false, forms: true }`. See [Handling Forms in Iframes](/sdk-reference/configuration#handling-forms-embedded-in-iframes).

***

## Integrations

### "My integration shows as connected but data isn't syncing"

1. **Re-authenticate:** OAuth tokens can expire. Go to **Settings > Integrations**, disconnect, and reconnect the integration.
2. **Check permissions:** ensure the authenticated user has sufficient permissions in the connected tool (e.g., admin access for CRM integrations).
3. **Wait for initial sync:** the first sync after connecting can take several hours as Avina backfills historical data.

### "Some integration options are greyed out in automations"

Disconnected integrations appear as disabled options with a **Connect** link. Click the link to navigate to **Settings > Integrations** and set up the connection. Once connected, the option becomes available.

***

## Automations

### "My automation isn't triggering"

1. **Check the trigger signal:** ensure the signal the automation is tied to is active and firing.
2. **Review your filters:** automation filters may be too restrictive. Check CRM field filters and ICP fit thresholds.
3. **Check automation status:** make sure the automation is set to **Active**, not **Paused**.
4. **Check destination connection:** if the destination integration (e.g., Outreach, HubSpot) is disconnected, the automation cannot execute.

### "Contacts are being filtered out of my automation"

Check the automation's enrollment history to see why contacts were filtered. Common reasons:

* ICP fit score below threshold
* CRM field doesn't match filter criteria
* Contact was already enrolled in the same sequence (deduplication)

***

## Enrichment

### "Contact data is missing or incomplete"

Avina uses a waterfall enrichment approach. Multiple data providers are queried in sequence. Some contacts may not have complete data if:

* The prospect has a limited online presence
* The company is very small or newly founded
* The email domain is personal (Gmail, Yahoo) rather than corporate

Enrichment data refreshes periodically as new sources become available.

***

## Still Need Help?

Contact us at [support@avina.io](mailto:support@avina.io) or use the in-app messenger for real-time assistance.