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

# Sync Issues

> Fix problems with calendar sync, recording uploads, integration delivery, and cross-device sync.

Mavio syncs data across multiple systems — your calendar, recording devices, cloud services, and third-party integrations. When something falls out of sync, this guide helps you identify and fix the issue.

## Calendar sync issues

### Meetings not appearing in Mavio

<Steps>
  <Step title="Verify calendar connection">
    Go to **Settings > Integrations > Google Calendar** (or Outlook). Check that the connection status shows **Connected**. If it shows **Disconnected**, click **Reconnect**.
  </Step>

  <Step title="Check selected calendars">
    Ensure the correct calendar is enabled. Click **Manage calendars** and verify your work calendar is toggled on.
  </Step>

  <Step title="Force a sync">
    Click **Sync now** to trigger an immediate calendar refresh. New meetings should appear within seconds.
  </Step>

  <Step title="Check the meeting link">
    Mavio only shows meetings that have a supported meeting link (Zoom, Google Meet, or Teams). Calendar events without a meeting link will not appear.
  </Step>
</Steps>

<Tip>
  If you recently changed your Google password or revoked app permissions, the calendar connection may have broken silently. Disconnect and reconnect the calendar to refresh the OAuth token.
</Tip>

### Bot not auto-joining scheduled meetings

If meetings appear in Mavio but the bot does not join:

1. Check that **Auto-join** is enabled in **Settings > Recording**.
2. Verify the meeting matches your auto-join filters (external only, minimum attendees, keyword match).
3. Check the meeting card — if auto-join is toggled off for that specific meeting, toggle it on.
4. Ensure the meeting has started. The bot joins within 30 seconds of the scheduled start time.

## Recording upload issues

### Recording stuck on "Uploading"

This means the audio file has not finished uploading to Mavio's servers.

| Cause                             | Fix                                                                                     |
| --------------------------------- | --------------------------------------------------------------------------------------- |
| Poor internet connection          | Connect to a stronger Wi-Fi network or wait for better connectivity                     |
| Very large file                   | High-quality recordings of long meetings may take time. Wait for the upload to complete |
| App closed during upload          | Reopen the Mavio app. The upload resumes automatically                                  |
| Mobile — cellular upload disabled | Enable **Upload over cellular** in app settings, or connect to Wi-Fi                    |

<Note>
  Recordings are queued locally and upload automatically when connectivity is available. No data is lost if the upload is interrupted — it resumes from where it left off.
</Note>

### Recording stuck on "Processing"

After upload, recordings are processed (transcribed, summarized). This typically takes 2-5 minutes. If a recording is stuck:

1. Wait up to 15 minutes — processing times vary with server load.
2. Check [status.mavioapp.com](https://status.mavioapp.com) for service outages.
3. If still stuck after 30 minutes, click the three-dot menu on the recording and select **Retry processing**.

## Integration sync issues

### Slack posts not appearing

1. Verify the Slack integration is connected: **Settings > Integrations > Slack** should show **Connected**.
2. Check that the Mavio app is added to the target channel. In Slack, open the channel > **Channel details > Integrations > Add Mavio**.
3. Review your channel routing rules — the meeting may be routed to a different channel than expected.
4. Check the meeting's processing status. Slack posts are sent after processing completes.

### Notion pages not created

1. Verify the Notion integration: **Settings > Integrations > Notion** should show **Connected**.
2. In Notion, confirm Mavio still has access to the target database: open the database > **Share > Connections** and look for Mavio.
3. If you moved or renamed the Notion database, update the target in **Settings > Integrations > Notion > Database**.

### CRM not logging meetings

1. Verify the CRM connection is active.
2. Check that the meeting attendees match contacts in your CRM (by email address). Meetings with unmatched attendees are not auto-logged.
3. Review your auto-log filters in **Settings > Integrations > \[CRM] > Auto-log rules**.

## Cross-device sync

### Recordings from desktop not appearing on mobile (or vice versa)

All Mavio data syncs through the cloud. If recordings are missing on another device:

1. Ensure you are signed into the same Mavio account on both devices.
2. Pull down to refresh the meetings list on mobile.
3. Check if the recording is still uploading or processing on the original device.
4. If using privacy mode with cloud sync disabled, recordings stay local and will not appear on other devices.

### Action items marked complete on one device but showing open on another

Action item status syncs in near-real-time. If you see a discrepancy:

1. Pull to refresh or reload the page.
2. Check your internet connection — changes queue locally when offline and sync when connectivity is restored.

## General sync troubleshooting

<AccordionGroup>
  <Accordion title="Force refresh all data">
    On the web app, hard-refresh the page (`Cmd + Shift + R` / `Ctrl + Shift + R`). On mobile, pull down on the main screen. On desktop, quit and reopen the app.
  </Accordion>

  <Accordion title="Clear cache">
    If stale data persists: **Web:** clear browser cache for app.mavioapp.com. **Desktop:** Settings > Advanced > Clear cache. **Mobile:** Settings > Advanced > Clear cache.
  </Accordion>

  <Accordion title="Check Mavio service status">
    Visit [status.mavioapp.com](https://status.mavioapp.com) for real-time system status. Sync issues during an outage resolve automatically when service is restored.
  </Accordion>

  <Accordion title="Contact support">
    If sync issues persist after trying these steps, send a diagnostic report from **Settings > Support > Send diagnostic report** and email [support@mavioapp.com](mailto:support@mavioapp.com).
  </Accordion>
</AccordionGroup>