Troubleshooting

Having trouble? Here are the resolutions for common issues you might encounter while using Velocity.

Snippets aren't expanding

If you type a trigger and press space, but nothing happens, check the following:

  • Extension Status: Is the Velocity extension enabled and active in your browser?
  • Trailing Space: Velocity requires a trailing space or enter keypress to confirm a trigger. Typing the trigger isn't enough; you must complete the word.
  • Exclusion List: Velocity automatically disables itself in certain highly-complex rich text editors where expansion could break the host site's internal formatting (for example, the composition iframe in some advanced configurations of Gmail).

Sync isn't working

If your snippets aren't syncing across devices:

  • Is Sync Enabled?: Open Settings and ensure the Enable Sync toggle is on.
  • Is your User ID set?: You must be logged in.
  • Check the Banner: Look for a yellow banner at the top of your dashboard. If it says "Sync is paused", click [Unlock to resume] and enter your passphrase. Velocity clears its decryption keys from memory when your browser restarts for security.

Email confirmation link goes to localhost

If you click the link in your signup confirmation email and it takes you to a broken "localhost" URL:

This was a known issue in versions prior to the v2 relaunch.

Resolution: The confirmation link now safely redirects through https://velocity-text.vercel.app/verify, which automatically routes to /confirmed (success) or /auth-error (expired link)—no manual token handling required.

If you still see a localhost URL, please update the extension to the latest version in your browser. Then, open the extension login screen and click Resend confirmation email to get a new set of working links.

Forgot encryption passphrase

If you forget your encryption passphrase, use your recovery codes (generated when you first set up sync).

  1. Open Settings -> Recover Account.
  2. Enter your recovery codes.
  3. Set a new passphrase.

Lost recovery codes

There is no server-side recovery path. Velocity uses true End-to-End Encryption. Only you possess the keys to decrypt your synced snippets.

If you lose both your passphrase and your offline recovery codes, your synced data cannot be recovered. However, your local snippets (the data currently existing in your active browser that never synced) will remain intact.

Next Step: Getting started with Velocity

← Back to Guides