Protect the vault

Move in. Back up. Export for the job ahead.

Turn Chrome-family or Firefox bookmarks into Pages and dossiers. Use a Redline All data JSON export for full vault-record backup, then choose focused formats for analysis, writing, citation tools, and sharing.

Redline’s vault is local to a browser profile. It is not automatically synchronized or backed up by Redline.

Never attach an unreviewed export to a public issue.A vault can contain private URLs, selected text, notes, tags, dossier names, source relationships, and citation metadata.

Redline All data JSON is the importable vault-record backup

An All data JSON export includes Redline’s schema version, export time, app version, pages, annotations, dossiers, tags, link records, claims, evidence relations, every source capture, and settings. It is the only format that restores Redline’s full vault-record structure, including readable witness history and capture-to-annotation associations; browser-bookmark import is a one-way migration into new Page and dossier records. A scoped JSON backup includes captures associated with the Pages in that scope, while non-JSON formats do not include full normalized capture text.

  1. Open the full Library and select Exports.
  2. In Export Builder, choose Scope → All data.
  3. Choose Format → JSON backup.
  4. Choose Export and save redline-backup.json outside the browser profile.
What the JSON file does not restoreImport keeps the destination installation’s current settings even though settings are present in the file. Domain-level notes, table/card view preferences, and Local Export History are Library conveniences stored separately and are not included in the JSON.

Create a fresh JSON backup before:

  • uninstalling or reinstalling Redline;
  • clearing browser, site, profile, or extension data;
  • resetting or replacing a browser profile;
  • moving research to another supported browser or computer;
  • running a large import or merge;
  • making operating-system or browser changes that could affect the profile.
A backup only helps if it survives the profile.Store the downloaded JSON somewhere outside the browser profile and include it in your normal backup routine.

Import and restore vault records

  1. Back up the destination vault first with Exports → All data → JSON backup → Export.
  2. In the full Library, select Imports. Under Import Redline backup, choose a Redline All data JSON file.
  3. Choose a Duplicate strategy and review the Import preview, record counts, and duplicate-normalized-URL count.
  4. Choose Apply Import.
  5. Review a few important pages, annotations, and dossiers before deleting older backups.
Duplicate strategyActual behaviorReview afterward
Skip duplicate normalized URLsIncoming Pages whose normalized URL already exists are excluded. Other incoming entity types still merge by ID.Confirm the annotations and dossier relationships you expected are present.
Merge incoming over existingAll incoming records are accepted; an incoming record overlays an existing record only when their IDs match.Pages with the same normalized URL but different IDs can remain as separate duplicates.

The preview checks for a supported schema version and the required pages, annotations, dossiers, links, tags, claims, evidence-relations, and—where required by the schema—source-captures arrays. It is not a deep audit of every record field. If validation rejects a file, keep the original untouched and see Import problems.

Import does not create an automatic rollback file.Export the current destination first. Imported settings are not applied; the destination’s settings remain in place.

Move from browser bookmarks Chrome & Firefox

Redline accepts Chrome-family bookmarks HTML and Firefox Bookmark Backup JSON in either build, turning an existing bookmark collection into the beginning of a working research library.

  1. Prepare the source file: in Chrome, Chromium, Edge, Brave, or another compatible Chrome-family browser, open the bookmark manager and choose Export bookmarks to create an .html file. In Firefox’s bookmark manager, choose Import and Backup → Backup to create a .json file; for this route, do not choose Export Bookmarks to HTML.
  2. Open Redline’s full Library and select Imports.
  3. Under Import browser bookmarks, select the bookmarks .html file or Firefox Backup .json file.
  4. Review the counts for bookmarks found, new Pages and dossiers, duplicate URLs, and unsupported URLs.
  5. Choose Import Bookmarks, then add the notes, tags, status, importance, annotations, and dossier context that make the sources useful.
Bookmark dataRedline result
HTTP or HTTPS URL and titleA new Page, using the bookmark date when available
Full nested folder pathA dossier named with that full path, such as Bookmarks Toolbar / Project / Sources
The same new URL in several foldersOne Page connected to each corresponding dossier
A URL already saved in RedlineSkipped without changing the existing Page
javascript:, data:, chrome:, place:, view-source:, or another non-web schemeReported as unsupported and skipped
A browser-bookmark file is not a Redline backup.Chrome-family bookmarks HTML and Firefox Bookmark Backup JSON do not contain Redline annotations, notes, tags, citation metadata, settings, or other vault relationships. The importer also ignores embedded data-URI favicon images. Use All data → JSON backup for Redline recovery.

Choose the right export

FormatBest useImportable by Redline?
JSON backupComplete or scoped vault-record backup, including related source captures, claims, and evidence relationsYes
Source Witness JSONOne capture’s manifest, normalized text, and integrity limitations; created from the stored witnessNo
CSV bundleTabular analysis; redline-csv-export.zip contains pages, annotations, dossiers, links, tags, claims, and evidence-relations CSV filesNo
Redline XMLStructured interchange with grouped claims and evidence relationsNo
MarkdownReadable source packs with claim conclusions, grouped evidence, quotes, sources, and rationalesNo
BibTeXLaTeX and reference workflowsNo
RISReference-manager interchangeNo
CSL JSONStandards-oriented citation data and a practical Zotero import pathNo
EndNote XMLEndNote-oriented citation interchangeNo
Academic MarkdownAnnotated bibliography, citation-key source pack, or footnote-ready listNo
Plain bibliographyConvenient readable citation linesNo

Understand export scope

Evidence-aware scopes preserve the complete trail. A selected claim brings its relations, annotations, and source pages; an included annotation brings its connected claim and the rest of that claim’s evidence. This closure keeps a focused export from separating a conclusion from the passages used to assess it.

In Library → Exports, Scope can be All data, Dossier, Tag, Domain, Pages only, or Annotations only. Scopes preserve useful relationships: Pages only also brings annotations on those pages, and Annotations only also brings their source pages. Dossier, tag, and domain exports likewise include related records rather than acting as strict single-table filters.

The sidebar’s Export tab is a faster all-data route with JSON, CSV, XML, and MARKDOWN buttons. Use the full Library’s Exports builder when you need a particular scope or a citation format.

Evidence files can reveal investigative context.Review claim text, conclusions, exact passages, source URLs, and relation rationales before sharing any export. Vault JSON backups and individual Source Witness JSON files can include preserved readable source text, capture times, and capture associations; non-JSON formats retain their existing output and do not include the full normalized capture text.

Citation metadata

Redline can read citation-related metadata from the current page, including common citation meta tags and structured data. Extraction happens locally and the fields remain editable.

Many websites provide incomplete, inconsistent, or incorrect metadata. Review author names, dates, titles, publication details, identifiers, and generated citation keys before using an export in formal work.

Important limitationsCSL JSON—not Zotero RDF—is the available standards-oriented Zotero path. Plain bibliography output is a convenient renderer, not guaranteed style-guide compliance.

What Redline cannot recover

If the local browser vault is removed and no JSON backup exists, Redline has no server-side copy to restore. A Markdown, CSV, XML, or citation export may preserve useful content, but the current importer cannot read those formats.

If data appears missing, first confirm that you are using the original browser profile. Do not uninstall, clear data, or overwrite the profile while investigating.