> For the complete documentation index, see [llms.txt](https://docs.drivepoint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drivepoint.io/using-the-web-app/plans/plan-sync.md).

# Plan Sync

### ⚙️ How Plan Sync Works

We sync your plan every time we detect a change. You can also sync yourself by clicking the triple dot and clicking on sync. 

Drivepoint Plan Sync validates every Excel plan during ingestion to ensure your model structure matches Drivepoint’s schema. The process includes:

1. **SharePoint → Drivepoint**: Your workbook is synced from your SharePoint drive using Microsoft Graph.
2. **Validation Checks**: We verify required tabs, data layout, and company matching.
3. **Data Warehouse Upload**: Once validated, the file is processed and loaded into your connected BigQuery dataset.
4. **Sync Result**: Success or error messages are logged and surfaced in the Plan Info panel.

If validation fails, Drivepoint provides:

* A short **hover message** directly on the plan.
* An expanded **Plan Info explanation** with detailed fix steps via the tripledot.

### 🪄 Tips for Successful Plan Syncs

✅ **Before syncing:**

* Close all open Excel sessions for that file.
* Make sure your plan includes all required tabs.
* Verify the **Company** name on the *Settings* tab matches your Drivepoint org.

🚀 **If you see repeated sync failures:**

1. Click the **⋮ (triple-dot)** next to the plan name.
2. Select **Plan Info** for error details.
3. Follow the suggested fix steps.
4. If needed, message Drivepoint Customer Success with the **timestamp, plan name, and file link**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.drivepoint.io/using-the-web-app/plans/plan-sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.