Zotero sync problems are incredibly common. Your library shows up perfectly on one device but nowhere else, or the sync button just spins forever without actually doing anything. Sometimes you get error messages. Other times, nothing happens at all.
Here’s what most people don’t realize: sync issues almost never fix themselves. Clicking that sync button over and over won’t help. You need to figure out what’s blocking the process and deal with it directly.
This guide shows you exactly why Zotero stops syncing and how to fix it. The solutions are simple enough that you can handle them yourself, and most take less than five minutes once you know what to do.
What’s Really Happening When Zotero Won’t Sync
Syncing is how Zotero keeps your research library consistent across all your devices. When you add a paper on your desktop, save a webpage on your laptop, or organize folders on your tablet, the sync feature ensures everything shows up everywhere. Without it, you’re basically managing separate libraries on each device.
The sync process moves two types of data: your library information (titles, authors, tags, notes) and your attached files (PDFs, documents, images). Each type syncs differently, which is why you might see your citations update while your PDFs remain stubbornly absent. The library data uses Zotero’s servers and rarely causes trouble because it’s small and simple. File attachments, though, are bulky and depend on either Zotero storage or WebDAV connections.
When sync breaks down, you’ll notice a few telltale signs. Your items might appear on one device but not another. The sync icon could spin endlessly without finishing. Error messages pop up claiming your storage is full or your connection failed. Sometimes the sync button just sits there doing nothing, completely unresponsive to your desperate clicking.
These problems compound quickly if you keep working across multiple devices without realizing sync has stopped. You end up with different versions of your library in different places, and merging them later becomes a messy puzzle. Files get duplicated, tags disappear, and your carefully organized collections turn into chaos. That’s why catching sync issues early matters so much.
Zotero Not Syncing: Likely Causes
Several things can prevent Zotero from syncing properly, and identifying the specific culprit saves you time. Here’s what typically goes wrong and why it happens in the first place.
1. Internet Connection Problems
Your network might look fine on the surface, but Zotero needs a stable, continuous connection to sync. Those brief drops in WiFi that don’t affect your browsing can completely interrupt a file upload. If you’re on a spotty connection or switching between networks frequently, sync will fail partway through.
Firewalls and security software sometimes block Zotero’s connection to its servers without warning you. Corporate networks, public WiFi with login pages, and VPN configurations can all interfere. Your device thinks it’s online, but Zotero can’t actually reach the servers it needs.
Even bandwidth throttling during peak hours can cause timeouts. If your internet provider slows down certain types of traffic, large file syncs might never complete. This explains why sync works fine in the morning but fails every evening when everyone’s streaming videos.
2. Storage Quota Exceeded
Zotero gives you 300 MB of free storage for file attachments. That sounds like plenty until you start saving PDFs of research papers, which average 2-5 MB each. Once you hit that limit, new files won’t sync, though your library data still will.
The tricky part is that Zotero doesn’t always show clear warnings when you’re approaching your limit. You might add files thinking they’re syncing when they’re actually just sitting on your local device. Then you switch devices and wonder where everything went.
3. Outdated Software Version
Running an old version of Zotero creates compatibility issues with the servers. The development team regularly updates how sync works, and older versions sometimes can’t communicate properly with the current system. Your local Zotero might be trying to speak a language the servers no longer understand.
Updates also fix bugs that cause sync failures. If you’ve been skipping update notifications, you could be dealing with a problem that was solved months ago. The software might work fine for everyday tasks but stumble specifically during sync operations.
4. Corrupted Database Files
Your Zotero database stores all your library information locally before syncing. If this database gets corrupted through a crash, sudden shutdown, or disk error, sync can’t read the data properly. The software might try to sync but keep hitting errors it can’t resolve.
Database corruption often starts small and grows worse over time. You might notice occasional sync hiccups that seem to fix themselves, but they’re actually symptoms of underlying damage. Eventually, the corruption becomes severe enough to stop sync completely.
File locks are another database issue. If Zotero didn’t close properly last time, it might have left files locked. When you restart and try to sync, the software can’t access its own database because those old locks are still in place. This creates a deadlock where sync can’t proceed.
5. WebDAV Configuration Errors
If you use third-party storage like Nextcloud or ownCloud instead of Zotero’s servers, your WebDAV settings need to be perfect. One wrong character in the server URL, username, or password breaks everything. These services also update their security requirements, and old settings that worked before might suddenly fail.
WebDAV servers sometimes change their folder structures or access permissions without notice. Your Zotero configuration still points to the old location, but the files aren’t there anymore. The sync process runs but can’t find anything to sync with, so it just hangs or throws vague errors.
Zotero Not Syncing: DIY Fixes
Getting sync working again usually doesn’t require any special tools or technical expertise. Try these solutions in order, and you’ll likely solve the problem before reaching the end of the list.
1. Check Your Internet Connection
Start by testing your actual connection to Zotero’s servers, not just your general internet. Open your web browser and visit sync.zotero.org to see if the page loads. If it doesn’t, your network is blocking access to Zotero specifically, even if other websites work fine.
Try temporarily disabling your firewall or antivirus software to see if that fixes sync. If it does, you’ll need to add Zotero as an exception in your security settings rather than leaving protection disabled. Most security software has a whitelist or trusted applications feature where you can add Zotero.
Switch to a different network if possible. Connect to your phone’s hotspot or try another WiFi network to rule out network-specific blocks. If sync suddenly works on the new network, you know the problem lies with your original connection, not with Zotero itself.
2. Verify Your Zotero Storage Space
Log into your Zotero account through the website and check your storage usage under Settings. If you’re at or near 300 MB, that’s your problem. You have three options: upgrade to a paid storage plan, delete some attachments you don’t need, or switch to WebDAV storage with a third-party provider.
Deleting attachments is straightforward but requires thought. Go through your library and remove PDFs you’ve already read and don’t need to reference again. Keep the citation data (which takes almost no space) and delete just the file attachments. You can always re-download papers later if needed.
3. Update Zotero to the Latest Version
Open Zotero and go to Help, then Check for Updates. If an update is available, install it immediately and restart the program. Sometimes you’ll need to close Zotero completely and reopen it after updating for changes to take effect.
On some systems, automatic updates get disabled accidentally. You might need to download the latest version manually from zotero.org. Uninstall your current version first if the installer gives you trouble, but your library data stays safe in a separate location. Reinstalling the program won’t delete your research.
After updating, click the sync button and watch what happens. Updated software often resolves sync issues automatically without any additional fixes needed. The new version might handle errors better or use improved sync protocols that work around whatever was causing your problem.
4. Reset Your Sync History
This fix tells Zotero to start fresh with syncing, which resolves many mysterious errors. Go to Edit, then Preferences, then the Sync tab, then click Reset under Reset Options. Choose “Reset File Sync History” first, as it’s less drastic than resetting everything.
You’ll see warnings that this might cause files to re-download. That’s normal and won’t cause problems as long as you’re not syncing huge libraries on a slow connection. The reset clears out any confused state that’s preventing proper sync. After clicking the reset option, close the dialog and manually trigger a sync.
If resetting file sync history doesn’t work, try the more comprehensive “Restore to Zotero Server” option. This makes your local library match what’s on the server exactly, overwriting any local-only changes. Only use this if you’re sure the server version is more complete than your local one.
5. Check WebDAV Settings
If you’re using WebDAV storage, verify every detail of your configuration. Go to Preferences, then Sync, then Settings under File Syncing. Click “Verify Server” after entering your details to test the connection immediately. Zotero will tell you specifically what’s wrong if verification fails.
Common WebDAV mistakes include using http instead of https, forgetting the exact folder path, or having an extra space in your username. Retype everything carefully rather than assuming your saved settings are correct. Sometimes copying and pasting introduces invisible characters that break the connection.
Check with your WebDAV provider to confirm their current server address and requirements. They might have migrated to new servers or changed authentication methods. Look for recent emails or announcements about service updates that could affect your connection.
6. Repair Your Zotero Database
Database corruption requires a more technical fix, but Zotero includes built-in repair tools. First, close Zotero completely. Then locate your Zotero data directory (you can find the location under Edit, Preferences, Advanced, Files and Folders). Make a complete backup of this entire folder before proceeding.
Download the Zotero database repair tool from the Zotero website. Run it according to the instructions, which will check your database for errors and fix what it can. This process might take several minutes if you have a large library. When it finishes, restart Zotero and attempt to sync again.
7. Contact Zotero Support
If none of these fixes work, something more unusual is happening that requires expert diagnosis. Visit the Zotero forums at forums.zotero.org where the development team and experienced users can help troubleshoot. Before posting, generate a Debug ID by enabling debugging under Help, Debug Output Logging, then reproduce your sync problem while logging is active. Submit the log and provide the ID in your forum post.
The Zotero team responds quickly to sync issues because they know how crucial the feature is. Include specific details about error messages, what you’ve already tried, and when the problem started. The more information you provide, the faster they can identify the root cause and suggest a solution.
Wrapping Up
Sync issues with Zotero usually stem from straightforward problems like connection troubles, storage limits, or outdated software. Most of them take just a few minutes to fix once you know where to look. The key is working through the solutions systematically rather than randomly trying things and hoping for the best.
Keeping Zotero updated and monitoring your storage usage prevents most sync problems before they start. Regular backups of your library give you peace of mind, even when technical issues pop up. Your research is too important to lose over a preventable sync failure, so taking these small preventative steps pays off when deadlines loom.