📄 Troubleshooting

Troubleshooting

This section helps you resolve the most common issues you may encounter while using MailDesk.

Most problems are caused by sync timing, account configuration, or email provider behavior — and can usually be fixed quickly.

Before contacting support, check the topics below.

If emails do not appear immediately or seem to be missing:
Emails are missing or delayed

This is the most common situation for new users.

Poll for updates: In the MailBox UI, you can trigger an immediate check for new emails. This bypasses the standard 2-3 minute wait time.
Folder Backfill: If you are missing old emails in a specific folder, go to Mailbox Accounts -> Folders tab -> select the folder -> click Trigger Backfill. This starts a deep historical search for that folder.

If you see messages like:

These issues usually require:

If you sent an email but can’t find it later:

If MailDesk behaves strangely:

Sync and refresh issues

Most sync issues resolve themselves after a short time.

If you see:

Folders, labels, and duplicates explained

This is often related to Gmail labels or IMAP server behavior.

If you’re unsure which article to read:

1️⃣ Check Emails are missing or delayed
2️⃣ Check OAuth problems (if applicable)
3️⃣ Check Sent mail issues
4️⃣ Contact support if the issue persists

Contact your support team or administrator if:

Include:

Most issues resolve themselves after sync completes.
Waiting a few minutes often saves a lot of time.