Managing your syncs
Reading dashboard statuses, running on demand, pausing, editing, and understanding what a run actually did.
7 min read · Updated July 2026
The dashboard
Every card shows the Attio source, the sheet tab, the direction, whether it’s scheduled, the last result, and when it runs next. Search by sync name, object, list, or sheet once you have a few.
| Status | What it means | What to do |
|---|---|---|
| Active | Scheduled runs are on. | Nothing, unless the last run flagged something. |
| Paused | Scheduled runs are off. | Resume when you’re done with whatever you paused for. |
| Running | A run is in progress. | Wait it out. Don’t start overlapping work. |
| Success | The last run finished with nothing blocking it. | Only look closer if the counts surprise you. |
| Partial | Some of it worked, some needs you. | Open the issue summary and fix the rows or fields it names. |
| Failed | The run couldn’t do its job. | Follow the suggested fix, reconnect, or email us. |
| Skipped | The run deliberately did nothing. | Check whether it’s paused, locked, ineligible, or misconfigured. |
Active
- What it means
- Scheduled runs are on.
- What to do
- Nothing, unless the last run flagged something.
Paused
- What it means
- Scheduled runs are off.
- What to do
- Resume when you’re done with whatever you paused for.
Running
- What it means
- A run is in progress.
- What to do
- Wait it out. Don’t start overlapping work.
Success
- What it means
- The last run finished with nothing blocking it.
- What to do
- Only look closer if the counts surprise you.
Partial
- What it means
- Some of it worked, some needs you.
- What to do
- Open the issue summary and fix the rows or fields it names.
Failed
- What it means
- The run couldn’t do its job.
- What to do
- Follow the suggested fix, reconnect, or email us.
Skipped
- What it means
- The run deliberately did nothing.
- What to do
- Check whether it’s paused, locked, ineligible, or misconfigured.
Running on demand
Hit Run Sync after a batch of sheet edits, after changing mappings, or when you don’t want to wait for the schedule. A paused sync has to be resumed first.
Batch your edits
Finish a coherent set of changes, then run once. Running after every cell edit just makes the issue list harder to read.
Pausing and resuming
- Pause before renaming headers, changing field types, restructuring a tab, or doing a big CRM cleanup.
- Pausing stops scheduled runs. It doesn’t delete the sync or anything on either side.
- Edits made while paused stay where they are, and get evaluated on the next run.
- If both sides changed the same field while paused, the usual conflict rules still apply.
Editing a sync
You can change the name, the direction, and the field mappings. Changing direction changes who’s allowed to overwrite whom, so read the warning before you save.
- 01
Pause and read the last run
Clear existing issues first, so old failures don’t get blamed on the new setup.
- 02
Make the smallest change that works
Just the direction or field pairs you actually need.
- 03
Re-check required mappings
Anything that creates Attio data still has to supply required fields.
- 04
Resume and verify
Run once on demand, then look at the changed, created, skipped, and issue counts.
Deleting a sync
Deleting a sync stops future runs and removes SheetSync’s configuration for that connection. It does not mean you want the Attio records or the sheet rows deleted.
Write down the setup first
If a sync matters to the business, note its source, tab, direction, and key mappings before you delete it — so it can be rebuilt on purpose rather than from memory.