Native Readwise to Tana Export!
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.
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?
How should Readwise tags be handled so they work well with Tana’s “topics” concept?
What’s the purpose of “reset sync status,” and what risk comes with it?
Why is merging super tags and fields necessary after import?
How do the AI commands connect to highlight data in Tana?
What knobs control AI output style in this setup?
Review Questions
- When would you choose to convert a live search into plain nodes and delete the original library nodes during sync debugging?
- What specific problem arises if you merge Readwise-created super tags into the wrong existing tag (i.e., not into the one Readwise created)?
- How does the AI template ensure it writes to the correct Tana field for each highlight?
Key Points
- 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
Use compact layout and custom formatting so multi-line highlights import as single nodes and appear under a consistent source-title header.
- 3
Map Readwise highlight tags into a Tana topics field (relationship-style tags don’t translate cleanly from Readwise descriptors).
- 4
Test with a small set of sources first; full exports can be hard to correct without creating duplicates.
- 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
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
Use the Tana AI template to generate topics, real-life applications, outreach targets, and analogies per highlight, tuning temperature and model as needed.