Mailbox troubleshooting · Practical guide
IMAP UIDVALIDITY reset: why a mailbox may need to be rescanned
Treat UIDVALIDITY changes as a new UID namespace and investigate sync behavior without manually rewriting cursors.
Reviewed · Examples are illustrative
Who this helps: Mailbox owners and administrators validating sending and reply access.
Define the decision
IMAP UIDs are meaningful within a mailbox’s UIDVALIDITY context. Zintara’s reviewed synchronizer resets its last-seen cursor when that validity value changes, allowing the mailbox to be rescanned.
Work through the procedure
- Confirm whether a provider migration or mailbox rebuild occurred.
- Have an operator inspect the old and current validity values without exposing message contents.
- Observe rescan progress and errors.
- Check duplicate handling using stable message identifiers before attempting any manual recovery.
Worked example
The following is a synthetic example for this procedure, not a customer result or performance benchmark.
Before rebuild: UIDVALIDITY 100, last UID 900
After rebuild: UIDVALIDITY 200, message UIDs reassigned
Correct interpretation: UID 900 from the old namespace is not a safe new cursor
Zintara behavior: reset the cursor for a rescanRead the result
A larger rescan can be expected after a namespace change. Repeatedly resetting state while it runs can create unnecessary work and complicate diagnosis.
Check before moving on
- Check for concurrent sync attempts.
- Verify a fresh controlled reply after the rescan.
Limits and next action
Messages without stable Message-ID values have weaker deduplication evidence. Do not assume a rescan provides exactly-once processing for every malformed historical message.
Source: RFC 9051: UIDs and UIDVALIDITY
Source references
Worked examples are illustrative. Editorial procedures are suggested methods, not measured performance claims or promises of additional product features. Check current provider guidance before changing mailbox configuration.
Related guides
- IMAP: mailbox access, folders and synchronization scope →
- IMAP folder mapping in Zintara: understand the INBOX boundary →
- Inbox sync failed in Zintara: isolate the mailbox and missing message →