Issues with Syncing Gmail Labels in Mailspring

Hello Everyone,

I’ve been using Mailspring for a few months now and have been generally happy with the performance and features it offers. However, I’ve recently encountered an issue when syncing my Gmail account with Mailspring.

Specifically, I’ve noticed that some of my labels from Gmail aren’t showing up in Mailspring, or they are syncing incorrectly. For instance, a few labels I’ve created in Gmail (like “Work” and “Important”) simply don’t appear in Mailspring, while others are being synced but seem to be out of place or mixed up with other labels.

Here’s a bit more information about the issue:

  • I’ve checked my Gmail settings, and all labels are correctly set up there.
  • I’ve tried re-syncing the account and restarting Mailspring multiple times, but the issue persists.
  • I’ve also made sure that my Gmail account is properly connected to Msbilspring under the account settings.

I’m wondering if anyone else has experienced this problem or if there’s a specific fix or workaround that might help resolve the label syncing issue. Any guidance or suggestions would be greatly appreciated!

Thanks in advance!

Regards
JesicaW

Gmail labels that are hidden in Gmail’s web settings (“Show in IMAP” is off) won’t appear in Mailspring. To fix this:

  1. Go to Gmail Settings → Labels in your browser.
  2. For each label you want to see in Mailspring, make sure “Show in IMAP” is enabled.
  3. Back in Mailspring, go to Preferences → General → Local Data → Reset Cache to force a fresh sync.
    Some nested labels (sublabels) can also be finicky — Gmail exposes them to IMAP with / as a separator, and occasionally they don’t surface cleanly. If you’re still missing specific labels after following those steps, let me know which ones and I can dig further.