Troubleshooting Vanguard Connections

Last updated: August 21, 2026

Overview

If a Vanguard account won't connect or has stopped updating in Mezzi, start with Refresh connection, then complete the repair prompt if you're asked for one. Most Vanguard issues are ordinary connection maintenance — a credential change or an expired authorization — and resolve without removing anything. If the account still won't hold a connection after a repair, email help@mezzi.com rather than deleting and re-adding it.

⚠ What You May See

These are Mezzi's general connection messages. They aren't specific to Vanguard, and they mean the same thing on any institution:

  • "This account never synced - refresh your connection"

  • "Your account connection stopped syncing. Please repair the connection."

  • "Account connection issue" on the institution card

  • "Refresh too soon" with "Please wait at least 1 hour before refreshing again."

  • A Vanguard balance that hasn't moved for several days while the market has

If you're seeing a specific Vanguard error message that isn't in this list, send it to us verbatim — exact error text is what lets us route the problem to the right provider.

⚙ How to Fix It

  1. Check the balance against Vanguard. If the total matches, the connection is fine and the issue is classification rather than syncing. Fund-level problems are covered in Why Do My Holdings Show as Cash Instead of Investments?.

  2. Refresh the connection. Open the Vanguard institution and choose Refresh connection. If you get "Refresh too soon," wait an hour — refreshing more often doesn't pull newer data.

  3. Complete the repair prompt if one appears. Repairs are usually a password or multi-factor re-authorization. Use the same credentials and second factor you use on vanguard.com.

  4. Confirm you're on the right Vanguard entry. Vanguard's personal investor site and Vanguard-administered workplace retirement plans are not always the same connection. If you're connecting a 401(k) or 403(b), search for the administrator named on your plan statement — see How to Connect Your Employer Retirement Account (401(k), 403(b), 457).

  5. Check for a duplicate before deleting anything. If you've connected Vanguard more than once, you may have two records where only one syncs. How to Remove Duplicate Accounts in Mezzi covers that, and Removing an Institution vs. Removing a Single Account explains what Delete institution actually removes.

  6. If the repair loops, stop and tell us. A connection that authenticates, reports success, and then immediately asks to be repaired again is not something you can fix from your side. Reconnecting repeatedly won't break it out of the loop.

💡 Why This Happens

Connections to any brokerage sit on top of a data provider's integration, and they lapse for ordinary reasons — a password change, a new multi-factor method, a session that expired, or maintenance on the institution's side. A refresh or a repair re-establishes the authorization, which is why those two steps resolve most cases.

When a repair loops instead, the cause is usually upstream at the institution or the provider rather than in your account. We've seen this pattern on other institutions, and the honest answer in those cases has been that no amount of reconnecting helps until the provider rebuilds the integration. If your Vanguard connection behaves that way, we want the case — it's how the issue gets raised with the provider.

Important Notes

You can't choose which data provider Mezzi uses for an institution; Mezzi shows one recommended entry per institution in Search thousands of institutions. If several Vanguard entries appear, choose the one matching the site you actually log in at.

If Vanguard can't hold a connection for you, adding the account manually is a reasonable interim answer. A manual account still counts toward your net worth, and you can enter holdings on it — see How to Manually Add an Account in Mezzi.

🗨 Still Need Help?

Email help@mezzi.com or text/call (415) 763-6997 with:

  • the Vanguard account name as it appears in Mezzi, and whether it's a brokerage, IRA, or workplace plan

  • the exact error text or a screenshot of the message

  • when it last synced correctly, and what you've already tried

  • a screenshot of the same account at Vanguard, if the balance is wrong

Common Questions

  • How often does a connected Vanguard account update? Connected accounts refresh automatically. You can also force a refresh, but not more than once an hour — hence "Refresh too soon."

  • Should I delete my Vanguard connection and start over? Not as a first step. Deleting the institution removes every Vanguard account under it and their history in Mezzi, and it rarely fixes a repair loop.

  • Can I connect a Vanguard-administered 401(k) the same way as my personal Vanguard account? Not necessarily. Workplace plans are indexed under the plan administrator on your statement, which may be a different entry in search.

  • Is my Vanguard login stored by Mezzi? No. Credentials are handled by the connection provider during sign-in and aren't stored by Mezzi.