Skip to content
On this page

Importing from other Clients

Omnivore allows importing data from other data sources. When using the import API, you are limited to three imports per a day.

The maximum file size for an import is 10MB. If your import exceeds this size please email for assistance.

We highly recommend using Omnivore for a few days before doing an import. This will give you a sense of the features available, how you'd like to structure your labels, and what data you'd like to have available in Omnivore.

Importing data from Matter

The Matter data importer is currently in beta, if you encounter any issues please notify us at

Omnivore supports uploading the file generated by exporting your data from the Matter app.

Import your Matter data using the Import Matter Archive Tool.

To export your data from Matter, go to My Account, and choose Export data, this will send you an email with your data in a file Upload that file using the uploader on this page.

The importer will ingest the URLs listed in the _matter_history.csv file. If the Archive contains an HTML content entry for the URL, the provided content will be used. Otherwise, Omnivore will attempt to refetch the URL.

Currently the importer does not support importing highlights and notes from Matter.

Importing CSV files

Omnivore can import a list of URLs supplied as a CSV file. The file should be formated as with five columns and a CSV header, the columns are:

  • url: unique URL (full url of the item to be imported).
  • state: Either ARCHIVED or SUCCEEDED (set to ARCHIVED to have your item archived on import). If the state is not specified, the item will be imported as SUCCEEDED.
  • labels: In the format [Label1, Label2, Label3], note the square brackets ([,]) around the list of labels. If the item has no labels this column can be empty. Labels can also also be separated with quotes, but due to CSV quote escaping they will need to be doubled, for example: "[""label1"",""label2""]". If the item has no labels this column can be empty.
  • saved_at: The unix timestamp in milliseconds the item was saved. If the item has no saved_at date, this column can be empty.
  • published_at: The unix timestamp in milliseconds the item was published. If the item has no published_at date, this column can be empty.

Example File:

url,state,labels,saved_at,published_at,SUCCEEDED,"[Handsome Developers, Profile Page]",1614556800000,1614556800000,,,,

Once you have a properly structured CSV file, you can drag it into your library on the web to initiate the import. Note that Omnivore has to fetch all the URLs in your import, so its a slow process.

Importing using the API

When importing data using the API, if you have a large number of URLs to import, it is best to use the uploadImportFile vs the savePage APIs.

The uploadImportFile API accepts a CSV file and performs an import in the background. The savePage API could encounter rate limits if used to import a large number of URLs.

An example of importing with the uploadImportFile API can be found here:

Issues with importing URLs

When importing, depending on the format of your data, URLs might be refetched by Omnivore. URLs that are no longer available online might fail to be fetched. In this case, an empty entry with just the URL should be added to your library.