Source Sync Issues

When Kowiki connects to your external sources — Google Drive, SharePoint, OneDrive, Dropbox, or GitHub — it periodically syncs content into your workspace. If something goes wrong during that process, this guide helps you identify and fix the issue.

Source shows "Disconnected"

A disconnected source means Kowiki can no longer authenticate with the external service. This typically happens when:

• The access token has expired or been revoked
• The account password was changed
• An admin removed the OAuth app authorization on the source side

To fix this:

1. Go to Settings → Sources.
2. Find the affected source and click Reconnect.
3. Re-authenticate with the external service when prompted.
4. Wait for the sync status indicator to show "Connected."

For detailed reconnection steps, see Managing Connections.

Files not appearing after sync

If you connected a source but expected files are missing:

1. Check folder selection — Open the source settings and verify you selected the correct folders or repositories. Kowiki only syncs content from folders you explicitly include.
2. Verify file type support — Kowiki syncs documents, spreadsheets, presentations, PDFs, Markdown files, and text files. Binary files, images without text, and unsupported formats are skipped.
3. Confirm source-side permissions — The account used to connect the source must have read access to the files. If files were shared with a different account, they will not appear.

Sync stuck or taking too long

Large initial syncs can take significant time depending on the volume of content:

• A workspace with fewer than 500 files typically syncs within a few minutes.
• Larger workspaces (1,000+ files) may take 15–30 minutes or more.

Check the sync status indicator on the source card in Settings → Sources. If it shows "Syncing" with a progress count, the sync is still active. If the indicator has not progressed for more than an hour, try triggering a manual sync.

Content not updating

If edits you made in the source are not reflected in Kowiki:

1. Check your sync frequency — Sync intervals vary by plan. Pro syncs every 6 hours, Pro+ every hour, and Business plans support real-time or custom intervals. See Plans Overview for details.
2. Trigger a manual sync — Go to Settings → Sources, find the source, and click Sync Now to pull the latest changes immediately.
3. Verify the file was saved — Some cloud editors (like Google Docs) auto-save, but others require an explicit save before changes are visible to external apps.

Deleted files still showing

When you delete a file from the external source, Kowiki marks the corresponding page as "removed" during the next sync cycle. These pages are not automatically deleted from your workspace to prevent accidental data loss.

To remove them:

• Navigate to the page and delete it manually from your wiki.
• Alternatively, wait for the scheduled cleanup cycle, which removes stale "removed" pages after 30 days.

Permission revoked on source side

If someone revokes your access to a shared folder or repository, Kowiki can no longer read those files. The affected pages remain in your workspace with their last-synced content, but they stop receiving updates.

To resolve this:

1. Request access to the folder or repository from the owner.
2. Once access is restored, trigger a manual sync to pull in any missed changes.
3. If access cannot be restored, consider removing the source and deleting the orphaned pages.