Get AI summaries of any video or article — Sign up free
Native Readwise to Tana Export! thumbnail

Native Readwise to Tana Export!

CortexFutura Tools·
5 min read

Based on CortexFutura Tools's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Create a Tana API token via API Tokens in Tana, then paste it into Readwise’s Tana export settings to enable automatic syncing.

Briefing

A native Readwise-to-Tana integration now syncs every Readwise highlight and note into Tana automatically, tagged and formatted so it can plug straight into a second-brain workflow. The practical payoff is speed and structure: once the integration is set up, highlights land in Tana as nodes with consistent metadata (title, source, URL, date, authors, and custom fields), while notes are imported alongside them—ready for search, organization, and AI actions.

Getting the sync working starts with creating a Tana API token, then pasting it into Readwise’s Tana export settings. The setup matters because it determines how multi-line highlights are handled and how Readwise’s templating language maps Readwise fields into Tana fields. The recommended configuration uses “compact layout” so highlights with line breaks concatenate into a single node. It also uses custom formatting so each imported highlight becomes a pairing node labeled with the full source title, with the highlight text indented beneath it.

The import template is built with Readwise’s templating syntax (double curly braces) to place highlight text, highlight location URLs, and highlight note text into specific Tana fields. A key design choice is how tags translate across systems: Readwise tags behave like descriptors of content, while Tana “super tags” behave more like relationships that define the structure of nodes. To keep topics usable in Tana, the workflow converts each Readwise highlight tag into a topics field (rather than trying to map Readwise tags directly onto Tana’s relationship-style tags). Highlights and notes also receive different super tags—highlights get a “highlight” super tag and notes get a “note” super tag.

Before running a full export, the guidance is to test with a small selection of sources to avoid importing everything in a messy state. Readwise can “reset sync status,” which re-imports items as new—useful for debugging formatting, but it can create duplicates in Tana. After import, highlights appear under a Readwise library node, and each highlight includes fields like URL, date, title, authors, category (article/book/tweet/video), plus the configured “read-wise location” field.

For day-to-day use, the workflow recommends building live searches in Tana based on the Readwise-created tags, such as pulling highlights from the last seven days into a daily note. If an export needs fixing, the process is to convert the live search results into plain nodes, convert references into nodes, and delete the original library nodes—then re-run export.

A major complication comes from Tana API limitations in early access: Readwise can’t see existing Tana tags and fields already present in a workspace. The workaround is to merge Readwise-created super tags and fields into the corresponding existing ones (always merging into the tag/field that Readwise already created, so Readwise keeps populating the right IDs). This merging applies to both super tags (e.g., highlight vs highlight) and fields (e.g., authors), ensuring live searches work across both imported and manually created content.

Finally, the integration becomes more than storage through an AI template installed into Tana. With AI commands wired to highlight super tags, users can generate topics from highlights, draft real-life applications, suggest who might be interested (for sharing or outreach), and produce analogies (e.g., “Swiss army knife” or “magic wand”) to deepen understanding. Users can tune creativity via temperature (0–2) and switch models (default GPT 3.5 turbo, or GPT-4) to change output style.

Cornell Notes

The Readwise-to-Tana integration imports every Readwise highlight and note into Tana automatically after an API token is set up. A templated export configuration maps Readwise data (highlight text, location URLs, notes, authors, titles, and more) into Tana fields, using compact layout to keep multi-line highlights together. Because Readwise can’t access existing Tana tags/fields via the API, the workflow requires merging Readwise-created super tags and fields into the workspace’s canonical ones so searches and metadata stay consistent. Once imported, live searches can surface recent highlights into daily notes, and an AI template can generate topics, applications, “who to talk to,” and analogies for each highlight. This turns a reading log into a structured, searchable second brain.

Why does the export template’s “compact layout” and custom formatting matter for Tana nodes?

Compact layout ensures highlights with line breaks (new line characters) concatenate into a single Tana node instead of splitting across multiple nodes. Custom formatting then controls the node structure—using the full source title as a header (e.g., “title (highlights)”) and indenting highlight text beneath it—so imported content stays readable and consistent for downstream searches and AI actions.

How should Readwise tags be handled so they work well with Tana’s “topics” concept?

Readwise tags function like descriptors of what’s inside the highlight, while Tana super tags behave like relationships defining node structure. Mapping Readwise tags directly to Tana relationships can produce nonsensical results (e.g., a quote tagged “decision making” becoming a relationship that doesn’t carry the intended meaning). The recommended approach converts each Readwise highlight tag into a topics field (via templating and “highlight tags” expansion), then uses Tana’s topics field for filtering and search.

What’s the purpose of “reset sync status,” and what risk comes with it?

Reset sync status makes Readwise treat previously synced items as new, re-importing them into Tana. That’s useful for debugging formatting or mapping issues, but it can create duplicates because the original nodes remain while new nodes are added. The workflow warns to only reset for items that haven’t been edited or actively used in Tana.

Why is merging super tags and fields necessary after import?

Tana API limitations mean Readwise can’t populate existing tags/fields already defined in the workspace. Instead, Readwise creates new super tags and fields (with new IDs). To make searches work across both imported and manually created nodes, those Readwise-created tags/fields must be merged into the workspace’s canonical ones—merging into the tag/field Readwise created so Readwise continues writing to the merged target.

How do the AI commands connect to highlight data in Tana?

The AI template configures commands like “get topics,” “apply this,” “spread the love,” and “make an analogy” to write into specific fields on highlight nodes. Each command uses a “Target node” reference to the highlight’s fields (not the field itself), so the AI output lands in the correct metadata field. Buttons can be added to the highlight super tag so users trigger AI per highlight with one click.

What knobs control AI output style in this setup?

Creativity is controlled by temperature (0 to 2): higher values produce more unpredictable, creative results. Model choice can be switched from the default GPT 3.5 turbo to GPT-4, which changes output quality and style. Different settings can yield different analogies and application suggestions for the same highlight.

Review Questions

  1. When would you choose to convert a live search into plain nodes and delete the original library nodes during sync debugging?
  2. What specific problem arises if you merge Readwise-created super tags into the wrong existing tag (i.e., not into the one Readwise created)?
  3. How does the AI template ensure it writes to the correct Tana field for each highlight?

Key Points

  1. 1

    Create a Tana API token via API Tokens in Tana, then paste it into Readwise’s Tana export settings to enable automatic syncing.

  2. 2

    Use compact layout and custom formatting so multi-line highlights import as single nodes and appear under a consistent source-title header.

  3. 3

    Map Readwise highlight tags into a Tana topics field (relationship-style tags don’t translate cleanly from Readwise descriptors).

  4. 4

    Test with a small set of sources first; full exports can be hard to correct without creating duplicates.

  5. 5

    If you reset sync status, expect new Readwise-created tags and duplicates in Tana, so live searches may need the updated tag name.

  6. 6

    Merge Readwise-created super tags and fields into your workspace’s canonical ones to overcome Tana API early-access limitations and keep searches consistent.

  7. 7

    Use the Tana AI template to generate topics, real-life applications, outreach targets, and analogies per highlight, tuning temperature and model as needed.

Highlights

Compact layout prevents multi-line highlights from fragmenting into multiple nodes, keeping imported content usable.
Because Readwise can’t access existing Tana tags/fields via the API, merging Readwise-created super tags and fields is essential for reliable live searches.
Resetting sync status is a debugging tool—but it can create duplicates and even change the active Readwise tag used for searching.
AI commands are wired to highlight fields through references, enabling one-click topic extraction, application drafting, and analogy generation per highlight.
Temperature (0–2) and model choice (GPT 3.5 turbo vs GPT-4) materially change the creativity and phrasing of AI outputs.

Topics

Mentioned

  • API
  • GPT