Frequently Asked Questions
General
What is X Bookmark Vault?
X Bookmark Vault is a Chrome extension that saves your X bookmarks into local browser storage so you can keep, search, open, and back up your saved posts from your own device.
Where is my vault stored?
Your vault is stored locally inside your Chrome profile on your device. Bookmark text, metadata, and downloaded media are not stored on our servers.
Does X Bookmark Vault store my X bookmarks on your servers?
No. Your vault stays on your device. The extension uses your own X API access and stores the archive locally in Chrome extension storage.
Does the extension work without an X API key?
No. X Bookmark Vault is BYO API: you connect your own X OAuth 2.0 app/client ID so the extension can read your bookmarks through your own X account access.
Does this work on Firefox, Safari, or mobile?
Currently, X Bookmark Vault is built for Chrome-compatible browsers that support Manifest V3 extensions.
Setup
How do I connect my X account?
Create or use an X OAuth 2.0 app, copy your Client ID, paste it into X Bookmark Vault, and approve access when X opens the authorization page.
What OAuth scopes do I need?
Use: tweet.read, users.read, bookmark.read, and offline.access.
What callback URL should I use in my X app settings?
Use the callback URL shown inside the extension. It is specific to your installed extension ID, so copy it directly from the app.
Why did X say “The user did not approve access”?
That usually means the authorization was cancelled, the callback URL does not match exactly, or the OAuth app is not configured with the required scopes.
Can I switch X accounts?
Yes, Vault Pro supports switching accounts. Each connected X account has its own local vault state so bookmarks from different accounts do not mix.
Sync And Backup
What is Quick Sync?
Quick Sync checks your recent bookmarks and saves new ones into your vault. It is meant for normal ongoing use.
What is Full Backup?
Full Backup walks through your bookmark history and saves as many bookmarks as X returns. It then downloads available media into your local vault.
Does Full Backup use X API credits?
Yes. Full Backup reads bookmark pages from the X API, so it can use X API credits depending on your X developer plan.
Does downloading media use X API credits?
No. Media downloads use saved media URLs. They do not call the X bookmarks API.
Does Retry failed media use X API credits?
No. Retry failed media only retries media files that were already found and marked as failed. It uses saved media URLs and does not spend X API credits.
What happens if I close Chrome during a backup?
The extension tries to recover interrupted Full Backup media downloads when Chrome starts again or when you reopen the extension.
Can I stop a Full Backup?
Yes. During bookmark fetching, you can stop after the current batch and save a partial backup. During media downloading, you can stop downloads directly.
What does “processed” mean in the progress bar?
Processed means the extension has attempted that many media files in the current download or retry stage.
Why does the number of media files change during backup?
The extension discovers media as it indexes bookmarks. Later stages may show a different total because they only count media currently eligible for that operation.
Auto Sync
Does auto sync run when Chrome is closed?
No. Chrome extensions can run scheduled work while Chrome is open. If Chrome is closed, auto sync resumes when Chrome starts again.
How often does auto sync run?
By default, auto sync checks about once per hour. Vault Pro users can customize the sync interval.
Why does it say “Next sync: After current sync”?
A sync or media download is already running. Auto sync waits until the current operation finishes.
Why is auto sync off?
Auto sync may turn off when the trial expires, when access is invalid, or when the current account has not enabled it.
Local Media
What does “saved offline” mean?
It means the photo or video was downloaded into the local browser vault and can be opened from this device even if it becomes harder to find on X later.
Why do some posts show “Not local”?
The bookmark was saved, but its media file was not downloaded locally. This can happen because of trial limits, failed media downloads, expired media URLs, or network issues.
Why do some media downloads fail?
Media URLs can time out, expire, be blocked, become unavailable, or fail because of network conditions. Use Retry failed media to try those items again.
Can I retry only failed media?
Yes. Open More, then use Media repair → Retry failed. This retries only failed media and does not spend X API credits.
Trial And Vault Pro
What is included in the free trial?
The trial lets you connect your X account, save bookmarks locally, test sync, and save local media for a limited number of historical bookmarks.
What does Vault Pro unlock?
Vault Pro unlocks unlimited local bookmark backup, automatic scheduled sync, photos and videos saved locally, export/import, and advanced sync controls.
What happens when my trial expires?
Your local vault remains available. Sync and Pro-only actions require Vault Pro.
Do I lose my saved bookmarks if I do not upgrade?
No. Your existing local vault stays on your device.
How much does Vault Pro cost?
Vault Pro is $4.99/month.
How do I activate Vault Pro after buying?
Open the Vault Pro screen, choose “Already paid? Enter license key,” paste your license key, and activate.
I paid but the extension still says trial. What should I do?
Make sure you pasted the correct license key into the extension. If it still fails, open Help and contact support with the error message.
Export And Import
What is Export Vault?
Export Vault creates a portable .xbvault.json file containing your saved bookmarks and local media records.
Does export upload my data anywhere?
No. Export writes a file from your local browser vault to your computer.
Where should I save exports?
We recommend a folder named X Bookmark Vault Exports. Chrome will remember your chosen export folder after you pick it.
Why does export take a while?
Large vaults can contain hundreds of megabytes of media. The extension streams the export to avoid running out of memory, but big files can still take time.
Can I import my vault on another computer?
Yes. Install the extension, activate Vault Pro, and import your .xbvault.json file.
Why does import say the file is empty or invalid?
Make sure you selected the complete .xbvault.json export file and that it was not interrupted while saving.
Privacy And Security
Can you see my bookmarks?
No. Your vault is stored locally on your device. We do not receive your bookmark archive.
Can you see my media files?
No. Downloaded media is stored in your local Chrome profile.
Can you access my X account?
The extension uses OAuth access you approve through X. It uses your own X API configuration and requested scopes to read bookmarks.
Can I remove my license from this browser?
Yes. Open About and choose Remove Pro. This removes the local license from the browser but does not cancel billing.
Does removing the extension delete my vault?
Usually yes. Chrome removes extension storage when an extension is uninstalled. Export your vault first if you want to keep a backup.
Troubleshooting
Why is sync stuck?
Large media downloads can take time, especially videos. Open More → Diagnostics → Copy log and send it to support if it stays stuck.
Why did I get “X API credits ran out”?
Your X developer account has no remaining credits for the requested API calls. Wait for your X quota to reset or upgrade your X developer plan.
Why did I get “Too Many Requests”?
X is rate limiting requests. Wait and try again later.
Why does the extension say “A sync is already running”?
A sync, backup, media download, or retry operation is already active. Wait for it to finish or stop it first.
Why does the popup briefly show nothing when opening?
The extension waits for Chrome storage to return your real vault status before showing the UI. This avoids flashing the wrong account, trial, or license screen.