> For the complete documentation index, see [llms.txt](https://portavi.gitbook.io/portavi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portavi.gitbook.io/portavi-docs/troubleshooting/sync-problems.md).

# Sync problems

## Nothing has synced at all

Check, in order:

1. **Is a tool connected?** Go to **Integrations**. A project with no connected tool never syncs.
2. **Is a board attached to the project?** Open the project's edit modal and confirm it points at a specific board, project or list.
3. **Is the project active?** Archived, inactive and completed projects do not sync.
4. **Does the connection need reauthenticating?** An amber **Reauthenticate** button on the integration card means its access expired.

## The sync bar says it needs reauthenticating

Access tokens expire, get revoked when someone changes their password, or are removed by an administrator in the connected tool.

Go to **Integrations**, select **Reauthenticate**, and approve again. Syncing resumes on the next cycle, or immediately if you press **Resync**.

## Only 1,000 tasks came across

That is the per-project limit, and the sync bar says so when a project is at it.

For Jira and Azure DevOps these are the 1,000 most recently updated tasks, so current work is present and only old history is missing.

If your board genuinely holds more than 1,000 live tasks, it is usually several efforts sharing a container; consider splitting it into more than one Portavi project.

## Tasks disappeared

Portavi mirrors the connected tool. If a task was deleted there, it goes from Portavi on the next sync; this is intentional, since the PM tool is the source of truth.

If tasks vanished that still exist in your tool, check whether the project is at the 1,000-task limit; work outside that window is not synced.

## The Resync button says a sync is already running

One sync per project at a time. A large project takes several minutes; wait for it to finish. The progress indicator in the sync bar shows it is still working.

## A sprint shows metrics but no tasks

Expected for older sprints. Portavi keeps task-level detail for the active sprint and the three most recently closed; beyond that only the stored figures remain, and the sprint says so rather than showing an empty list.

## Phases are empty on a Waterfall project

Check the project's **phase mapping** in its edit modal; it tells Portavi how your board's structure corresponds to phases. Tasks not matching any phase are listed separately rather than hidden.

## Monday.com will not connect

If authorising Monday ends on an error mentioning an invalid scope, the app has not been installed in that Monday account yet. Only a Monday admin can install it, and it has to happen once before anyone can connect. See [Monday.com needs an admin the first time](/portavi-docs/connecting-your-tools/project-management-tools.md#monday-com-needs-an-admin-the-first-time).

## Still stuck

Note the project name and roughly when you last saw a successful sync, then contact your PMO manager, or email us at <support@portavipmo.com>. **Contact support** is also in the footer of the help panel inside Portavi.