Sync Not Working

You've connected Google Drive or OneDrive but the files aren't showing up in your Documents library. Work through this checklist to find the cause.

The Sync History tab showing a completed sync run with file counts and any skipped files
The Sync History tab showing a completed sync run with file counts and any skipped files

Step 1: Check that a sync actually ran

Go to Settings → Data Connectors, click your connector, and open the Sync History tab.

  • If the list is empty or the last run is old: the sync may not have run yet. Click Sync now to trigger an immediate sync.
  • If the last run shows an error: see Connector Failures to fix the underlying problem first.
  • If the last run shows "0 files synced" or fewer files than expected: the files may be filtered out (see steps below).

Step 2: Files over 25 MB are skipped

Files larger than 25 MB are silently skipped during connector sync. The sync run will show a "skipped" count in the Sync History details.

Fix: For large files, either:

  • Split the file into smaller parts in Drive/OneDrive before syncing
  • Upload the file manually to Hubrix Documents (manual uploads support up to 50 MB)

Step 3: Check your include/exclude glob patterns

If you configured include or exclude globs on the folder, they may be filtering out the files you expect.

  1. Go to the folder settings in the connector.
  2. Review the Include and Exclude patterns.
  3. Test whether your file name matches the pattern. Note that *draft* would exclude a file named final-draft-v2.pdf because "draft" appears in the middle.
  4. Adjust or remove the pattern that is incorrectly matching your file.

Glob patterns are case-sensitive on some connectors. If your pattern uses lowercase but your file names use uppercase, they may not match.

Step 4: Google Workspace files take longer to convert

Google Docs, Sheets, and Slides are converted to DOCX, XLSX, and PPTX during sync. The conversion process adds a few extra seconds per file.

If Google Workspace files are missing after a sync, wait a few minutes and refresh the Documents library. They may still be processing.

If a Google Workspace file shows a Failed status, the conversion may have failed due to a complex formatting issue in the source file. Try exporting the file manually from Google (as DOCX/XLSX/PPTX) and uploading it manually.

Step 5: File is an unsupported type

Only the 9 supported file formats are indexed. Files in any other format (images, ZIP archives, video files, executable files, etc.) are silently ignored during sync.

Check the file extension against the supported formats list.

Step 6: Force a manual sync

If you have addressed a potential cause and want to verify the fix, click Sync now on the connector. The sync runs immediately and the Sync History tab updates within a minute or two.

If a file was previously synced and then deleted from Drive/OneDrive, Hubrix will remove it from your Documents library on the next sync (for OneDrive, which uses delta sync). For Google Drive, file deletions are detected on the next full crawl of the folder. If you want to remove a deleted file immediately, delete it manually from the Documents library.

Was this helpful?