Xmarks User Manual An easy to understand guide on how to use Xmarks.

Chrome Troubleshooting

Xmarks for Chrome occasionally runs into an internal error. This is generally caused by an Xmarks upgrade or rare bug that gets Xmarks for Chrome confused. If you're stuck in a situation that is stopping you from syncing, it's usually easiest to go to the advanced Xmarks settings and manually start a download. This will completely remove your local bookmark information and replace it with the bookmarks you have saved on our servers. This should get Xmarks for Chrome synchronizing successfully again (Note: although you will lose any changes made since your last sync. To preserve your bookmarks you can also try an upload instead of a download, although this is not as bulletproof as a download).

If you find yourself doing this more than a couple of times, please contact us! This is a one time fix that should get everything working correctly again. If it does not, you may be encountering a new bug that we'd love to fix.

Common Errors

Unable to process Xmarks node [bookmark name]: Invalid URL

This means that the URL for listed bookmark name is invalid in Chrome. Xmarks should catch any invalid URL before attempting to write it to Chrome, but we haven't caught every edge case yet. We'd really appreciate it if you contacted us so we can figure out what case we're missing and fix it in the next release. Additionally, you can work around the issue by following these steps:

  • Login to http://my.xmarks.com
  • Hit the search button at the top and search for the offending bookmark name
  • Take a look at the URL for that bookmark. It's probably (hopefully!) very funky looking.
  • Delete the bookmark

Sync should work after that. But please make sure to contact us too so we can actually fix the problematic URL!

Unable to process Xmarks node [bookmark name]: This request exceeds available quota

You are most likely running Xmarks sync and Chrome bookmark sync. Yes? The easiest answer is to disable Xmarks auto sync and only synchronize manually between machines. If you're not using Chrome bookmark sync, please feel free to contact us if you're running into this issue.

Unable to process Xmarks node [Other Bookmarks]: Can't modify the root bookmark folders.

This is probably due to an earlier Xmarks bug that accidentally created an extra "Other bookmarks" folder in your account. These steps should fix things:

  • Log in to http://my.xmarks.com
  • Look for a folder named "Other Bookmarks" in your root folder
  • Move any bookmarks one at a time from the affected folder into your root folder
  • Delete the "Other Bookmarks" folder using my.xmarks.com
  • Open Xmarks for Chrome, go to the advanced tab, and manually start a download

Uncaught Error: didn't find child [id] in parent [id, usually ROOT].

This is most likely caused by a recent change of data structures we are using to store your bookmark data in Chrome. The easiest way to fix this is to go to the advanced Xmarks Settings tab and manually start a download. This will replace your current bookmarks in Chrome with the most recent set you have saved on our servers. You will lose any recent changes you've made to your bookmarks in Chrome (that haven't been synchronized back yet), but it should get sync working correctly again.

That should get everything back up and synchronizing correctly.

Contact Us

Accessing log data

Before contacting Xmarks, take a second to look through your log file. Errors in the log file will help us track down the root issue more quickly.

To see log output, go to chrome://extensions/ and click the link to inspect the background.html view for Xmarks. (Note: if you don't see the option to inspect anything, you'll need to click the "Developer mode" link in the top right first.) Our log data is printed to the console, which can be toggled using the buttons at the bottom of the inspector. Any Chrome errors will be printed in red.