What is Readwise Reader?
Readwise Reader is a powerful extension of the Readwise platform designed to enhance your digital reading experience. Reader brings together all your reading materials—articles, newsletters, EPUBs, PDFs, videos, tweets, and more—into one unified, customizable platform and seamlessly integrates with Readwise.
With Reader, you can highlight and annotate text as you read, and all your highlights and notes will automatically sync to your Readwise library for easy organization and review.
## Where should I start?
Great question! With so many options for importing, exporting, and customizing, getting set up with Reader can feel daunting. To help ease the mental load of a new system, here are some ideas:
1. [Import existing content](/reader/docs/faqs/importing-content) from Pocket, Instapaper, Feedly, or other platforms.
2. [Add new content](/reader/docs/faqs/adding-new-content) using the browser extension, mobile share sheet, or drag-and-drop file upload.
3. [Subscribe to RSS feeds](/reader/docs/faqs/feed) to get new content in your account every day.
4. [Customize Reader's appearance](/reader/docs/faqs/appearance) to suit your reading preferences—make the text bigger, turn on paged scroll, switch to dark mode, and more.
5. Start reading and annotate as you go with simple [highlighting and note-taking](/reader/docs/faqs/highlights-tags-notes) functionality.
## What else can I do with Reader?
An even better question! To learn more about the deep cuts of Reader's feature set, check out these resources:
What is Readwise Reader?
Readwise Reader is an all-in-one reading app designed to enhance your digital reading experience. Reader brings together all your reading materials—articles, newsletters, EPUBs, PDFs, videos, tweets, and more—into one unified, customizable platform and seamlessly integrates with Readwise.
With Reader, you can highlight and annotate text as you read, and all your highlights and notes will automatically sync to your Readwise library for easy organization and review.
## Where should I start?
Great question! With so many options for importing, exporting, and customizing, it can be nice to have a jumping off point. To help you get started, here are some ideas:
1. [Import existing content](/reader/docs/faqs/importing-content) from Pocket, Instapaper, Feedly, or other platforms.
2. [Add new content](/reader/docs/faqs/adding-new-content) using the browser extension, mobile share sheet, or drag-and-drop file upload.
3. [Subscribe to RSS feeds](/reader/docs/faqs/feed) to get new content in your account every day.
4. [Customize Reader's appearance](/reader/docs/faqs/appearance) to suit your reading preferences—make the text bigger, turn on paged scroll, switch to dark mode, and more.
5. Start reading and annotate as you go with simple [highlighting and note-taking](/reader/docs/faqs/highlights-tags-notes) functionality.
## What else can I do with Reader?
To learn more about some of Reader's more advanced features, check out these resources:
Reader API Documentation
The Reader API just supports saving new documents to Reader and fetching your documents. We will add more endpoints in the near future. If you have any questions, please [reach out :)](mailto:api@readwise.io)
Looking for the API docs for the original Readwise? [See here](/readwise/docs/api).
## Authentication
Set a header with key "Authorization" and value: "Token XXX" where XXX is your Readwise access token. You (or your users) can get that from here: [readwise.io/access_token](https://readwise.io/access_token)
If you want to check that a token is valid, just make a GET request to `https://readwise.io/api/v2/auth/` with the above header. You should receive a `204` response.
## Rate Limiting
The default base rate is 20 requests per minute (per access token) but the `Document CREATE` and `Document UPDATE` endpoints have higher limits of 50 requests per minute (per access token). You can check `Retry-After` header in the 429 response to get the number of seconds to wait for.
---
## Document CREATE
**Request**: `POST` to `https://readwise.io/api/v3/save/`
**Parameters:**
A JSON object with the following keys:
| Key | Type | Description | Required |
|-----|------|-------------|----------|
| url | string | The document's unique URL. If you don't have one, you can provide a made up value such as `https://yourapp.com#document1` | yes |
| html | string | The document's content, in valid html (see examples). If you don't provide this, we will try to scrape the URL you provided to fetch html from the open web. | no |
| should_clean_html | boolean | Only valid when `html` is provided. Pass `true` to have us automatically clean the html and parse the metadata (title/author) of the document for you. By default, this option is `false`. | no |
| title | string | The document's title, it will overwrite the original title of the document | no |
| author | string | The document's author, it will overwrite the original author (if found during the parsing step) | no |
| summary | string | Summary of the document | no |
| published_date | date | A datetime representing when the document was published in the ISO 8601 format; default timezone is UTC. Example: `"2020-07-14T20:11:24+00:00"` | no |
| image_url | string | An image URL to use as cover image | no |
| location | string | One of: `new`, `later`, `archive` or `feed`. Default is `new`. Represents the initial location of the document (previously called `triage_status`). Note: if you try to use a location the user doesn't have enabled in their settings, this value will be set to their default location. | no |
| category | string | One of: `article`, `email`, `rss`, `highlight`, `note`, `pdf`, `epub`, `tweet` or `video`. Default is guessed based on the URL, usually `article`. | no |
| saved_using | string | This value represents the source of the document | no |
| tags | list | A list of strings containing tags, example: `["tag1", "tag2"]` | no |
| notes | string | A top-level note of the document | no |
**Response:**
- Status code: `201` or `200` if document already exist
- Created document details:
```json
{
"id": "0000ffff2222eeee3333dddd4444",
"url": "https://read.readwise.io/new/read/0000ffff2222eeee3333dddd4444",
}
```
**JavaScript Example:**
```javascript
$.ajax({
url: 'https://readwise.io/api/v3/save/',
type: 'POST',
contentType: 'application/json',
beforeSend: function (xhr) {
xhr.setRequestHeader('Authorization', 'Token XXX');
},
data: JSON.stringify({
"url": "https://example.com/article/",
"html": "This article is awesome
content here!
Highlights
New highlights added at
```
Note the if statement used above. By default, the header is formatted differently when the highlights are for a newly synced page versus new highlights on a previously synced page.
A common use case may be that you don't want the highlights backlinked to the date (the day they are synced). If that's the case, you can simply remove the [[]] wrapping the date, e.g:
```
Highlights synced by #Readwise: at
```
### Sync Notification
Finally, every time you export your Markdown highlights, we can optionally generate a special markdown file which summarizes which files were added/updated.
This setting is off by default, but it can be especially useful in note-taking apps that create a page for the date the highlights were exported and can be linked to that.
How does the Readwise to NotebookLM integration work?
## Export your Readwise highlights to NotebookLM
The Readwise integration with NotebookLM is powered by Google Docs, so the export will create a new document or documents in your Google Drive that contain your highlights and notes.
To get started with the sync, select the NotebookLM Export link from your [Readwise export page](https://readwise.io/export).
This will prompt you to log in with your Google account. Once you've logged in, use the "Select all" button (1) to grant Readwise full access, then click "Continue" (2).
On the [export configuration page](https://readwise.io/export/google-docs/preferences), you'll find a few options:
1. **Export Automatically**: Keep this on if you would like NotebookLM to sync daily. You can turn it off if you would prefer to only update your Google Docs when you manually trigger an export from this page.
2. **Include Highlight Locations**: Turn this on to include the location or page information of each highlight in the export.
3. **Send a single document to your drive**: Turn this on to send all highlights in a single document. Turn it off to create a Google Doc for each Readwise document. *Note that creating a single Google Doc will make it much easier to add all of your highlights to a single notebook and allow you to chat and interact with your highlights and notes.*
4. **Select Items to be Exported**: Turning this option on will allow you to manually select which documents will be exported to Google Docs. When this option is turned off, all documents in your account will sync when an export is triggered.
## Use your notes as a source for NotebookLM AI
1. In your [NotebookLM account](https://notebooklm.google.com/), click **New notebook**.
2. Use the **Google Docs** link to select your Readwise highlights as the notebook's source.
### Create an AI podcast from your highlights in NotebookLM
In the **Notebook guide** panel (1), click the **Generate** button under **Audio Overview** (2).
### Generate structured docs from your highlights
In the **Notebook guide** panel (1), click one of the options under **Help me create** (2). This will generate a structured document—an FAQ, a table of contents, a briefing, etc.—using your highlights as a source.
### Chat with your highlights
Using the text field at the bottom of the page, you can ask questions, search for information and quotes, and explore your library of notes and highlights.
How does the Readwise to Notion export integration work?
To get started with the Notion sync, select the Notion option on your [Readwise Export page](https://readwise.io/export).
Readwise will ask for authorization to connect with your Notion account. (If you're not already logged into Notion, you'll be prompted to do so.)
On the first authorization screen, click **Next**. On the second, select the first option ("Use a template provided by the developer"), then click **Allow access**.
Once you configure the Readwise to Notion integration, Readwise will automatically synchronize all your highlighted documents to a database in Notion.
The first time Readwise syncs with Notion, a new table called "Readwise" will be created in a private page of your selected Notion workspace. The process may take several minutes depending on how many books, articles, tweets, and highlights you have in your library. Feel free to close the export browser and move on to something else—the export will continue in the background. Also, once you're initially caught up, new highlights will automatically be synced to Notion periodically throughout the day.
By default, the Readwise table in Notion is separated into filtered views of Book, Article, Tweet, and Podcast pages, each of which contains all your highlights for that category of document. You can filter, sort, and search this table using all the power of Notion databases.
## How can I configure the Readwise to Notion integration?
There are a few options you can change on the [Notion integration settings page](https://readwise.io/export/notion/preferences). Here's a breakdown of what each setting does.
1. **Start Export:** Use this button to manually trigger an immediate export to Notion.
2. **Export Automatically:** Keep this on if you would like Notion to sync daily. You can turn it off if you would prefer to only update Notion when you manually trigger an export from this page.
3. **Include Highlight Locations:** Keep this on to include the location or page information of each highlight in the export.
4. **Use Compact Layout:** This will display the location information inline with the highlight text and won’t add any dividers between highlights. Toggling it off will separate the location information to a different line and will add dividers to the page between each highlight.
5. **Select Items to be Exported:** Turning this option on will allow you to manually select which documents will be exported to Notion. When this option is turned off, all documents in your account will sync when an export is triggered.
6. **Documents to be exported:** If the *Select Items to be Exported* option (4) is toggled on, you'll see a list of all your documents. To select which ones are included in the export, use the checkboxes on the left side of the title.
## What happens when I take new highlights? Will those automatically sync with Notion?
Yes! Whenever you import a new highlight into Readwise, it will be automatically exported to Notion without you needing to do anything. If the highlight is from a new document, a new page in the Notion table will be made. If the highlight is from an existing document, the highlight will be appended to the bottom of the existing page.
Certain services such as Amazon Kindle, Instapaper, and Pocket only synchronize with Readwise a few times a day. For this reason, new highlights may not immediately appear in either Readwise or Notion. If you need to sync sooner, you can force a manual resync from the [Import Highlights page](https://readwise.io/welcome/sync).
## Can I add new properties to the Readwise table in Notion?
Yes! You can add as many additional properties to the Notion table as you wish and those will not be overwritten by Readwise in subsequent syncs. You can even change the names of the default properties if you'd like.
However, be careful not to delete or change the [property type](https://www.notion.so/help/database-properties) for any of the default properties, or the sync will break.
## Can I move either the Readwise table or individual pages to another location in my Notion workspace?
Yes! You can move either the whole Readwise table or individual document pages within your Notion workspace and the Readwise integration will still find and properly update those.
If you'd like to move an individual page to another location and maintain the sync, you'll want to first make sure that the Readwise integration has access to the new location you're moving it to. You can do this by clicking into the "..." menu in the top right while viewing the intended destination page, going down to the Connections section and opening the "Connect to" menu, then searching for Readwise:
## Can I rename the title of a document page in Notion?
Yes! You can rename either the whole table or individual document pages and the Readwise integration will still find and properly update those.
## Can I edit the text of a document page in Notion?
Yes! You can edit the text of a page as you wish and the Readwise integration will not overwrite any changes you make. New highlights will be appended to the bottom of the page.
## Can I make adjustments to the filters and views of the database?
Yes! By default, the Readwise table in Notion is separated into filtered views based on document type (e.g. Book, Article, Tweet), each of which contains all your highlights for that entry. You can filter, sort, and search this table using all the powerful features Notion offers.
## Where does the Location link above each Kindle highlight take me?
If you have the Kindle app installed on your computer, clicking the Location link will launch the Kindle app and jump you to the highlight in the book. More on those links here: [Can I jump to a highlight directly in the Kindle app?](/readwise/docs/importing-highlights/kindle#can-i-jump-to-a-highlight-directly-in-the-kindle-app)
## If I edit or format an existing highlight in Readwise, or make a new note or tag to an existing highlight, will that change be updated in Notion?
No. All of our export integrations with note-taking apps are append-only. This means that Readwise won't overwrite anything that's already in your Notion account so that we don't accidentally erase anything you may have edited or added directly in Notion. That said, you can [re-export your highlights to Notion](/readwise/docs/exporting-highlights) for any documents you'd like to update.
## How do I delete my Readwise table and start over?
1. Delete the Readwise page in Notion
2. Click the Trash section in Notion and permanently delete the Readwise page
3. Initiate the sync from the [Notion preferences page](https://readwise.io/export/notion/preferences) in Readwise
## How do I change the Notion workspace to export to?
To change which Notion workspace or account your Readwise highlights export to, go to the [Readwise Export page](https://readwise.io/export) and find the Notion card in the **Connected** section. Click the `...` icon in the top right, then select **Change account**. This will display a popup warning that you will be disconnecting from your current workspace, which you'll need to confirm in order to continue.
Once you've done that, you can follow the instructions at the top of this page to reconnect to a new Notion workspace or account.
## How do I disconnect my Notion account from Readwise?
You can disconnect your account from the [Export page](https://readwise.io/export) by clicking the `...` in the top right of the Notion card and selecting **Remove connection**.
How does the Readwise to Obsidian export integration work?
To begin exporting your Readwise highlights to Obsidian, you first need to install the Readwise Official plugin from within your Obsidian Vault:
1. Click **Settings** within Obsidian (typically in the bottom left corner)
2. Select **Community plugins** (if Safe mode is on, you'll need to turn it off to install Community plugins)
3. Click **Browse** and search for **Readwise Official** (note that there are a few other Readwise plugins, so be sure to choose the official version)
4. Click **Install**
5. Click **Enable**
6. Back out of the installation screen to return to the Settings screen
7. Scroll in the left sidebar until you see Readwise Official
8. Finish the configuration from there
The Readwise Obsidian plugin offers numerous customization options (described in the [customization section below](#how-can-i-customize-the-readwise-to-obsidian-export)), but below is an example of what the export looks like by default using our cofounder Dan's Readwise library:
Similar to the Evernote, Notion, and Roam integrations, the Readwise plugin can be set to automatically sync new highlights to Obsidian whenever they're made.
## What happens when I take new highlights? Will those automatically sync with Obsidian?
Yes! You can configure the Readwise Obsidian plugin to automatically sync any new highlights that come into Readwise. If the highlight is from a _new_ book, article, or Twitter account, a new page in the Obsidian vault will be made. If the highlight is from an _existing_ book, article, or Twitter account, the highlight will be _appended_ to the bottom of the existing page. Because the Readwise plugin is append-only, nothing in Obsidian will ever be overwritten.
Certain services such as Amazon Kindle, Instapaper, and Pocket only synchronize with Readwise a few times a day. For this reason, the highlight may not immediately appear in either Readwise or Obsidian. If you need to sync sooner, you should first force a manual resync in Readwise (from the [Add Highlights](http://readwise.io/sync) section of the [Readwise Dashboard](http://readwise.io/dashboard)) and then initiate a sync in Obsidian from either the plugin menu or the command panel.
## How do I trigger a new sync from within Obsidian?
By default, the Readwise plugin will be set to automatically sync when you open the Obsidian app and to manually sync otherwise. If syncing is set to manual, you can trigger a new sync by either visiting the plugin page and clicking "Initiate Sync" or using the command palette and searching for "Readwise Official: Sync your data now." Alternatively, you can set the plugin to automatically check Readwise for new highlights every 1, 12, or 24 hours.
## What happens when I update highlights in Readwise? Will those changes automatically sync with Obsidian? (Or vice versa?)
At the moment, no. Because Obsidian uses a page as its atomic unit, it would be quite technically challenging to programmatically search through an existing page for the right highlight and update that text without accidentally overwriting edits by the user.
## Can I rename the file of a book, article, or Twitter page in Obsidian?
As of this current release, if you rename a file that was generated by the Readwise plugin, the plugin will create a new file with that name on the next export. This means it's fine to rename files for books and articles where you do not expect to take any more highlights, but if you're continuing to take highlights in a document, you will end up with two files.
## Can I move either the Readwise folder or individual pages to another location in my Obsidian vault?
Similar to the answer above, if you move a file that was generated by the Readwise plugin, the plugin will create a new file in the original location _if you took new highlights_. This means it's fine to move files for books and articles where you do not expect to take any more highlights, but if you're continuing to take highlights in a document, you will end up with two files.
## Can I edit the text of a book, article, or Twitter page in Obsidian?
Yes! You can edit the text of a page as you wish and the Readwise integration will not overwrite any changes you make. New highlights will be appended to the bottom of the page.
## How do I reset the export of my whole library or an individual document to start fresh?
Obsidian makes it easy to reset the Readwise export: simply delete either an individual page that you want to refresh or the whole folder and then initiate a fresh Readwise sync. Note that you'll need to have "Resync deleted files" checked ON within the Readwise Official plugin page in Obsidian.
## Where does the Location link after each Kindle highlight take me?
If you have the Kindle app installed on your computer, clicking the Location link will launch the Kindle app and jump you to the highlight in the book. More on those links here: [Can I jump to a highlight directly in the Kindle app?](/readwise/docs/importing-highlights/kindle#can-i-jump-to-a-highlight-directly-in-the-kindle-app)
## Can I change the default directory to which Readwise exports my highlights?
Absolutely. You can do this from the "Customize base folder" setting within the Readwise Official plugin page.
## Can I use a flat folder structure instead of grouping files into Books, Articles, and Tweets?
Absolutely. You can achieve this by toggling the "Group Files in Category Folders" settings to OFF from the [Obsidian Export](https://readwise.io/export/obsidian/preferences) page on Readwise.
## Can I export the full text of my documents to Obsidian?
Yes! You can do this by toggling the "Export All Reader Documents" setting to on from the [Obsidian Export](https://readwise.io/export/obsidian/preferences) page on Readwise.
This will export a second file for each of your Reader documents with the full text of the document. To keep things organized, this new document will be linked from the original file with your highlights.
***
## How can I customize the Readwise to Obsidian Export?
One of the most powerful features of the Readwise to Obsidian plugin is the ability to customize the formatting of how your highlight data is imported into Obsidian. You can customize a variety of elements including:
- Properties (previously known as YAML front matter)
- Page title
- Metadata (such as author, URL, category, title, cover image)
- Highlight header (inserted whenever new highlights are added)
- Highlights themselves (e.g. inclusion of links to original, tags, notes, etc.)
- Sync notifications (a new entry in Obsidian each time the Readwise plugin runs)
To begin customizing your export, head to the Obsidian Export page from your Readwise Dashboard.
Each component of the export has a "template" using the Jinja2 templating language. The explanations below should illustrate how customization works, and give some useful examples.
### Page Title
By default, Readwise will insert the title of each document as an H1 (# in Markdown) in the default template:
```
#
```
Notice the `` variable. As your highlights are exported to Obsidian, Readwise will replace the `` variable with the document's actual title.
Let's say you wanted the first line of your export to be the document's title, plus the word "Highlights" in parentheses. All you would have to do is append the text " (Highlights)" to the template as follows:
```
# (Highlights)
```
You can customize this much more using inline-if statements, Jinja2 filters, and much more. The templating language is quite powerful!
### Metadata
One of the nicest aspects of the Readwise plugin is that each document can be enhanced with additional metadata such as author name, document URL, document tags, category, full title, cover image, and more.
The default template below will insert the cover image, if there is one, followed by H2 Metadata, followed by the author's name with double brackets, full title, document category (i.e. Book, Article, or Tweet) with a hashtag, followed by document tags in Readwise, if any.
```
![rw-book-cover]()
## Metadata
- Author: [[]]
- Full Title:
- Category: #
- Document Tags: [[]]
- URL:
```
Below is an example of how you'd modify the category line if you wanted to append an emoji to each category tag:
```
Category: #
```
Again, this templating language is quite powerful! You go much deeper with the customization using inline-if statements, Jinja2 filters, and more.
### Highlight Header
Another component of the template is the Header text that appears above each set of synced highlights. The first time a document is exported to Obsidian, the Highlight section will be delineated by an H2 Header. Any new highlights taken in this document will be appended beneath a new H2 header including date and time stamp.
```
## Highlights
## New highlights added at
```
A common use case in tools for thought such as Roam Research and Obsidian is to backlink the date in this header to your Daily Notes page. To make this work for yourself, you'll need to format the `` variable to match your Daily Notes formatting. For example, if your Daily Note uses the format of `YYYY-MM-DD`, you could match that format by modifying the filter on the date variable like so: ``
### Highlights
Of course, you can also format the export of the highlights themselves. By default, each highlight is inserted as a bullet (using a dash), followed by a hyperlink to the original highlight and then sub-bullets for any tags and notes attached to the highlight.
```
- ([]()) ()
- Tags: [[]]
- Note:
```
As mentioned above, there is much more you can do using inline-if statements, Jinja2 filters, and so on.
### Summary
The `` variable can be used in the Page Metadata or Properties (YAML Front Matter) sections of the export template. You can use this variable to add the summary of documents highlighted in Reader, which can be entered into a document's data manually or generated by Ghostreader, Reader's AI reading copilot.
### Properties (a.k.a. YAML Front Matter)
Many power users of Obsidian use the Dataview plugin to accomplish database-like queries from within Obsidian. This requires a special header at the beginning of the Markdown using YAML. By default, this section of the template is off, but if you're a power user of Dataview/YAML, you can insert the front matter as desired.
### Sync Notifications
Finally, you can configure the Readwise plugin to append an entry to a special file each time the sync runs. This notification is particularly useful in tools such as Roam Research where the backlink appears more front and center in the Daily Note, but is off by default in Obsidian.
### File and Folder Names
To edit the format of the exported file names, toggle the "Use Custom File Name" setting to ON from the Obsidian export page. This can be useful if you have a specific way you'd like to organize your files in your Obsidian vault. For example, to prepend the file name with the last name of the document's author, you could use this template:
```
--
```
If "Group Files in Category Folders" is toggled ON, you can customize folder names for each category of document (i.e. Books, Articles, Tweets, and Podcasts).
How does the Readwise to OneNote export integration work?
## Setting up your OneNote export
To get started with the OneNote sync, select the OneNote option on your [Readwise Export page](https://readwise.io/export).
Clicking the **Connect** button will prompt you to log in to your Microsoft account. Once you've done so, you'll be asked to grant Readwise permission to access your notes. Click **Accept** to proceed with the sync.
Once you've given Readwise access, you can configure the export from the [export preferences page](https://readwise.io/export/onenote/preferences).
1. **Start Export:** Use this button to manually trigger an immediate export to OneNote.
2. **Export Automatically:** Keep this on if you would like OneNote to sync daily. You can turn it off if you would prefer to only update OneNote when you manually trigger an export from this page.
3. **Include Highlight Locations:** Keep this on to include the location or page information of each highlight in the export.
4. **Select Items to be Exported:** Turning this option on will allow you to manually select which documents will be exported to OneNote. When this option is turned off, all documents in your account will sync when an export is triggered.
5. **Documents to be exported:** If the *Select Items to be Exported* option (4) is toggled on, you'll see a list of all your documents. To select which ones are included in the export, use the checkboxes on the left side of the title.
## OneNote Export FAQs
### Where do my Readwise highlights go in OneNote?
The integration will create a “Readwise” notebook in your OneNote account with subsections for Articles, Books, Tweets, etc. Each document will be imported as a note under its respective notebook section and will contain all of the document's highlights and notes.
When you first import your Readwise documents into OneNote, you may see that some of them don't have their proper title in the list of notes and just say "Untitled." As far as we can tell, this is a loading issue on Microsoft's end, but it doesn't mean the import is broken!
To fix the issue, just click into the document. After the initial load, the title will appear and should stick around.
### What happens when I add new highlights?
Any highlights you’ve made in existing documents since the last sync will be appended to the end of the existing note for that document in OneNote.
### How do highlight notes work with the OneNote integration?
Any notes and tags attached to a highlight will export to OneNote with the highlight. However, if you edit the notes or tags of a highlight after it has already been exported to OneNote, you’ll need to re-export the documents to see those updates in your OneNote account.
### How can I refresh a document in OneNote?
If you’ve edited a document or highlight in Readwise and would like to re-export it to OneNote with the changes, you can do so via the following steps:
1. Go to the [OneNote export preferences page](https://readwise.io/export/onenote/preferences).
2. Toggle ON **Select Items to be Exported** (1).
3. Ensure that the document is selected to be exported (2), then click the refresh button to the far right (3).
4. Click **Start Export** at the top of the page.
This will create a duplicate note in OneNote with the updated content. You can delete the old version and any new exports will sync to the new note.
### How do I completely refresh all of the exported highlights in my OneNote account?
If you would like to completely refresh all the Readwise content in your OneNote account, you can do so using these steps:
1. On the [Readwise export page](https://readwise.io/export), click the `...` in the top right corner of the OneNote export card and select **Remove connection**. A warning dialogue will appear; click **Confirm** to continue.
2. To avoid duplicates, delete the Readwise notebook in your OneNote account.
3. From the [Readwise export page](https://readwise.io/export), click the OneNote card to reconnect your accounts. Follow the instructions at the top of this page to configure the fresh export.
How does the Readwise to RemNote export integration work?
To get started with syncing your highlights to RemNote, click on "Connect" on the RemNote option from Export Highlights on your [Readwise Dashboard](https://readwise.io/dashboard).
You will be redirected to Remnote's "Plugins and Themes" page. Click on "Install" and then "Authorize plugin."
In a separate tab, find your [Readwise Access Token](https://www.readwise.io/access\_token). Click on “Get Access Token” and then “Copy to clipboard.”
Return to RemNote's Settings page and select "Plugin Settings" tab. Paste the copied access token in the “Readwise API Key” field.
To perform the initial sync, enter the command “Readwise Sync All” in Remnote's Omnibar. It will take a few minutes to sync, and a pop-up message confirming “Import done!” will appear. From that point onwards, imports will happen automatically in the background roughly every 30 minutes without needing to run any further commands.
## What happens when I take new highlights? Will those automatically sync with RemNote?
Yes! Whenever you import a new highlight into Readwise, it will be automatically synced with RemNote by default without you needing to do anything. If the highlight is from a _new_ book, article, or Twitter account, a new page in the "Readwise Books" folder in RemNote will be made. If the highlight is from an _existing_ book, article, or Twitter account, the highlight will be _appended_ to the existing page.
Certain services such as Amazon Kindle, Instapaper, and Pocket only synchronize with Readwise a few times a day. For this reason, the highlight may not immediately appear in either Readwise or RemNote. If you need to sync sooner, you should first force a manual resync in Readwise (from the [Add Highlights](http://readwise.io/sync) section of the [Readwise Dashboard](http://readwise.io/dashboard)) and then initiate a sync in RemNote.
## What happens when I update highlights in Readwise? Will those changes automatically sync with RemNote? (Or vice versa?)
When you modify highlights in Readwise, the changes automatically synchronize with RemNote. However, the current Readwise to RemNote export integration is not bidirectional, so any updates made to highlights in RemNote will not be reflected in Readwise. We aim to enable bidirectional syncing for all note-taking apps in the future!
## Can I rename the file of a book, article, or Twitter page in RemNote?
You can modify the title of a page created by Readwise in RemNote, but keep in mind that the next time your data syncs, the original Readwise title will return. Rest assured, the content inside the page won't be overwritten in this process.
## Can I edit the text of a book, article, or Twitter page in RemNote?
Feel free to edit the content on any page generated by Readwise in RemNote. However, be aware that if you make changes to the highlights in Readwise later on, your previous edits in RemNote will be replaced. Don't worry though, any sub-bullets you've added under highlights will remain untouched.
## How do I reset the export of my whole library or an individual document to start fresh?
RemNote makes it easy to reset the Readwise export: simply delete either an individual page that you want to refresh or the whole folder and then initiate a fresh Readwise sync.
## Can I customize the default note format of my highlights in RemNote?
Currently, default customization is not an option. The new Readwise to RemNote export integration does not permit you to alter the formatting of your imported highlight data in RemNote.
## Where does the Location link after each Kindle highlight take me?
Currently, you cannot jump directly from RemNote to the Kindle app. Instead, you will be directed to your Readwise highlights. If you have the Kindle app installed on your desktop, clicking the Location link will launch the app and take you to the specific highlight in the book. Learn more about these links here: [Can I jump to a highlight directly in the Kindle app?](/readwise/docs/importing-highlights/kindle#can-i-jump-to-a-highlight-directly-in-the-kindle-app)
How does the Readwise to Roam export integration work?
To get started with syncing your highlights to Roam Research, select the Roam option from Export Highlights on your [Readwise Dashboard](https://readwise.io/dashboard).
When you first sync to Roam, Readwise will limit the export to your most recent 10 items (books, articles, and tweets), to give you a feel for how the integration works. The Roam integration has numerous customization options, described below. Once you've confirmed everything is working to your liking, you can then go back and select all of your items for syncing.
Here's what the Readwise to Roam integration looks like by default (using Azlen's CSS theme Zenith):
After the initial setup, Readwise will sync new highlights to Roam automatically, enabling some powerful use cases. For example, each new highlight includes a backlink to your Daily Note of the day they were synced (see above on the left).
## How do I reset the integration so I can start over fresh?
If you ever want to "reset" the Readwise integration to Roam and perform a fresh resync, then all you need to do is delete any reference to #Readwise from your database. The easiest way to do this is to:
* Go to the All Pages view in Roam (from your side bar)
* Search for #Readwise
* Select All
* Double check that only pages you want to reset and resync are selected
* Delete
On the next sync attempt, Readwise will detect that the notes were deleted within Roam and run a fresh sync of all of your selected books/articles!
## What happens when I take new highlights? Will those automatically sync with Roam?
Yes! Whenever you import a new highlight into Readwise, it will be automatically synced with Roam without you needing to do anything. If the highlight is from a new book, article, or Twitter account, a new page in the Roam database will be made. If the highlight is from an existing book, article, or Twitter account, the highlight will be _appended_ to the bottom of the existing page. Because the Readwise integration is append-only, nothing in Roam will ever be overwritten.
Certain services—such as Amazon Kindle, Instapaper, and Pocket—only synchronize with Readwise a few times a day. For this reason, the highlight may not immediately appear in either Readwise or Roam. If you need to sync sooner, you can force a manual resync from the [Add Highlights](http://readwise.io/sync) section of the [Readwise Dashboard](http://readwise.io/dashboard).
## Can I customize the default how my notes are formatted in Roam?
Absolutely! See [customization section below](#how-can-i-customize-the-readwise-to-roam-export) for how to customize the note's title, metadata, headers, and sync notifications.
## Where does the Location link after each Kindle highlight take me?
If you have the Kindle app installed on your desktop, clicking the Location link will launch the Kindle app and jump you to the highlight in the book. More on those links here: [Can I jump to a highlight directly in the Kindle app?](/readwise/docs/importing-highlights/kindle#can-i-jump-to-a-highlight-directly-in-the-kindle-app)
## Can I rename the title of a book, article, or Twitter page in Roam?
Currently, you _can_ rename a page generated by Readwise, but if you do and then add new highlights to that book/article, the Readwise integration will create a second page using the original title for new highlights. So we recommend not changing the title for now, or only doing so after you're done reading a piece!
## How do I change the Roam graph I'm exporting to?
1. Remove the Roam connection from the [Readwise export page](https://readwise.io/export).
2. [Re-connect the Readwise integration](https://readwise.io/export/roam-api/preferences).
## How can I customize the Readwise to Roam Export?
One of the most powerful features of the Readwise to Roam integration is the ability to [customize the formatting of exactly how you'd like your data imported into Roam](https://readwise.io/magicaltrashpanda).
You can customize the formatting of your notes:
* Page title
* Metadata (such as author, URL, category, title, cover image)
* Highlight header (parent of any new highlights added)
* Highlights themselves (links to original, tags, notes, etc.)
* Sync notification (shows up in the #Readwise page, letting you know of new highlights from your daily)
You can customize your export by going to the [Roam Export Preferences](http://readwise.io/export/roam/preferences) page and toggling on "Use custom formatting."
At a high level, each component of the export customization has a "template" that uses the [Jinja2 templating language](https://jinja.palletsprojects.com/en/2.11.x/). You can customize each of these templates to achieve your desired formats in Roam. As you tweak the templates in Readwise, you'll be able to see a live preview of what your notes will look like in Roam.
The explanations below should illustrate how customization works, and give some useful examples. And if you're looking for more metadata examples and explanations, [check out this great guide :)](https://roamstack.com/feed-roam-using-readwise/)
***
### Page Title
By default, Readwise will append "(highlights)" to each page so you can differentiate a Readwise created page from your own. Here's the default template:
```django
(highlights)
```
Notice the `` variable. When a note comes into Roam, that `` will be replaced with the book/article/tweet's actual title.
You also have some other variables available to you. For example, here's how you can prepend each title with the category (i.e. is this a book, article, or tweet?)
```django
/
```
This would result in something like Book/Atomic Habits.
If you want all of your Readwise highlights to just show up in one page (though we don't recommend this), you could set the template to a non-variable string such as this:
```django
```
Of course, you can customize the title significantly further, using [inline-if statements](https://stackoverflow.com/a/14215034/1522443), [Jinja2 filters](https://jinja.palletsprojects.com/en/2.11.x/templates/#filters), and [much more](https://jinja.palletsprojects.com/en/2.11.x/templates/). The templating language is quite powerful!
### Page Metadata
From the [Roam Preferences](http://readwise.io/magicaltrashpanda) page, you can also edit your Roam page metadata, including the author, URL, category, title, image, and anything else you want to show up when each new book/article/tweet is imported.
Here's the default template:
```django
Author:: [[]]
Full Title::
Category:: #
Document Tags:: #
URL::
![]()
```
Here's an example of some modifications you can make to, e.g. create a TODO for each new highlight, add custom backlinks, and customize formatting based on the category of book/article/tweet.
```django
#twitter 🐦
[[TODO]]"}} #toprocess process & summarize the highlights from this book
This is a podcast/article
Author:: [[]]
Full Title::
Category:: #
Document Tags:: #
URL::
![]()
```
### Highlight Header
You can customize how the Header text above each set of synced highlights is formatted. By default, each time your highlights are synced they will be sub-bullets of this default header:
```django
Highlights first synced by #Readwise [[]]
New highlights added [[]] at
```
Note the `if` statement used above. By default, the header is formatted differently when the highlights are for a newly synced page versus new highlights on a previously synced page.
A common use case may be that you don't want the highlights backlinked to the date (the day they are synced). If that's the case, you can simply remove the \[\[]] wrapping the date, e.g:
```django
Highlights synced by #Readwise: at
```
### Highlight Content
Customizing the highlight itself is a little more complex, but can support some insane workflows. Here's the default template:
```django
([]()) ()
**Tags**: #[[]]
**Note**:
```
Note the indentation above. The highlight text is shown at the top level, with the location information (e.g. page number, link back to article/tweet, etc.) inline with it. Nested under the highlight text are any notes and tags attached to that highlight, if they exist.
Why might you want to customize the highlight text? For one, maybe you'd just like to tweak the default formatting, e.g. putting notes inline or at the parent level.
Here's an example of how you can embed saved tweets directly into Roam, rather than having just their text sync:
```
([]()) ()
**Tags**: #[[]]
**Note**:
```
You might also want to enable a more complex workflow, like having all of your highlights synced to the same page, regardless of books. Here's how you might do that:
```
([]()) ()
Category: [[]]
Title: [[]]
Author: [[]]
**Tags**: #[[]]
**Note**:
```
In this case, you would also change the Page Title template to something like:
```
```
(Note that because this example uses no variables, all highlights will have the same page title and thus write to the same page.)
There is, of course, much more you can do with this.
## Sync Notification
Finally, every time Readwise syncs new highlights you've made into your Roam account, it appends a message into your #Readwise page in Roam to notify you of the updates. This links to your daily note as well, so you can see all the highlights you made in one day. Here's the default template:
```
On [[]] at Readwise synced highlight from book.
```
Note the use of the pluralize filter from Jinja2, which makes the note read more naturally. In the case that you **don't** want these notifications in your daily note, you can simply unlink the date reference like so:
```
On at Readwise synced highlight from book.
```
If you don't want these sync notifications _at all_, you can delete the entire template for sync notifications.
How does the Readwise to Tana export integration work?
Before you can export your Readwise highlights to Tana, you'll need to create an [API token](https://help.tana.inc/tana-input-api.html) for your Tana workspace:
1. In the Settings panel of Tana (represented by a gear icon), click API Tokens.
2. Select the Workspace you want your Readwise exports to appear in.
3. Click the + Create button.
4. Once the token is created, click Copy to save it to your clipboard.
5. In your Readwise account, go to the [Tana setup page](https://readwise.io/export/tana/token) and paste the token into the API field.
6. Click Save.
You'll then be directed to the integration options page.
The export has a variety of customization options (outlined in [the customization section below](#how-can-i-customize-the-readwise-to-tana-integration)), but the default format will create a node for each document and tag it with the Supertag #Readwise. The highlights from the document will be nested underneath the document node and tagged with #highlights.
Note: If you plan to customize your formatting, we recommend doing a test export by enabling the "Select Items to Be Exported" option and choosing a few documents with a variety of metadata, to ensure that the export works as you expect. Once you've tweaked the options to your liking, you can re-export those few documents using the "refresh" icon on the far right of the document.
This interactive tutorial will guide you through the process of generating your API key and configuring the Readwise integration:
## What happens when I take new highlights? Will those automatically sync with Tana?
Yes! You can configure the Readwise Tana integration to automatically sync any new highlights that come into Readwise. If the highlight is from a _new_ book, article, or Twitter account, a new node will be created in your Tana account. If the highlight is from an _existing_ book, article, or Twitter account, the highlight will be _appended_ to below the existing node. Because the Readwise integration is append-only, nothing in Tana will ever be overwritten.
Certain services such as Amazon Kindle, Instapaper, and Pocket only synchronize with Readwise a few times a day. For this reason, the highlight may not immediately appear in either Readwise or Tana. If you need to sync sooner, you should first force a manual re-sync in Readwise (from the [Add Highlights](http://readwise.io/sync) section of the [Readwise Dashboard](http://readwise.io/dashboard)).
## How do I trigger a new sync to Tana?
By default, the Tana integration will export any new highlights as soon as they appear in Readwise. (Note that it may still take a few minutes for them to appear in your Tana account.) If you've disabled that option or simply want to force a fresh sync, you can click the "Start export to Tana" button on the [Tana Export settings page](https://readwise.io/export/tana/preferences).
## Can I edit the text of a book, article, or Twitter page in Tana?
Yes! You can edit the text of a highlight as you wish and the Readwise integration will not overwrite any changes you make. New highlights will be appended as a new node.
## What happens when I update highlights in Readwise? Will those changes automatically sync with Tana? (Or vice versa?)
Currently, no. New updates to existing highlights will not be reflected in already synced highlights. We want to make sure we don't overwrite any manual edits you might have made in your Tana workspace.
## Where does the Location link after each Kindle highlight take me?
If you have the Kindle app installed on your desktop, clicking the Location link will launch the Kindle app and jump you to the highlight in the book. More on those links here: [Can I jump to a highlight directly in the Kindle app?](/readwise/docs/importing-highlights/kindle#can-i-jump-to-a-highlight-directly-in-the-kindle-app)
## Can I customize how my notes appear in Tana?
Absolutely! See [the customization section below](#how-can-i-customize-the-readwise-to-tana-integration) for more information on how you can customize the title, metadata, and more.
## Can I add new properties to my tags in Tana?
Yes! You can add as many new properties to the tags within Tana as you'd like and Readwise won't overwrite them in any subsequent syncs.
Do note that if you make any changes to the properties that Readwise creates (e.g. author, title, etc.), Readwise may not recognize it as the same schema on the next sync and may create a duplicate. If that happens, you can [merge the tags](https://help.tana.inc/how-do-i-merge-nodes-fields-or-tags.html) as needed.
## How do I reset the integration so I can start over fresh?
You can reset the integration by creating a new API token in your Tana workspace and replacing the previous one in your Readwise account. (You can access the token setup page from the link at the bottom of the [export options page](https://readwise.io/export/tana/preferences).)
This will prompt a fresh export the next time you sync, ignoring any previously exported content. This is also useful if you want to sync your Readwise account to a different Tana workspace.
## How can I customize the Readwise to Tana integration?
One of the most powerful features of the Readwise to Tana integration is the ability to customize exactly how you would like the formatting of your notes to appear in Tana.
The customizable elements include:
* Note title
* Highlight formatting (links to original, tags, notes, etc)
* Metadata (such as author, URL, category)
You can customize your export by going to the [Tana export preferences page](https://readwise.io/export/tana/preferences) and turning on the "Use Custom Formatting" toggle.
Each component of the export customization has a "template" using the [Jinja2 templating language](https://jinja.palletsprojects.com/en/2.11.x/). You can customize each of these templates to achieve your desired format in Tana.
### Title
By default, Readwise will append "(highlights)" to each node so you can differentiate a Readwise created node from your own. Here's the default template:
```
(highlights) #
```
Notice the `` variable. When a note comes into Tana, that `` will be replaced with the document's actual title.
The `#` variable is also included here so that Tana will recognize the document categories (books, articles, etc.) as tags. This will allow you to view your notes by category and to add or edit the Supertag properties for them.
Note: All documents exported from Readwise will also be appended with the #Readwise tag. This is not a customizable part of the template because it is part of the integration's core functionality and shouldn't be removed.
You also have some other variables available to you. For example, here's how you can prepend each title with the name of the author:
```
- #
```
Of course, you can customize the title significantly further, using [inline-if statements](https://stackoverflow.com/a/14215034/1522443), [Jinja2 filters](https://jinja.palletsprojects.com/en/2.11.x/templates/#filters), and [much more](https://jinja.palletsprojects.com/en/2.11.x/templates/). The templating language is quite powerful!
### Highlight
This section is a little more complex, but can support some powerful workflows. Here's the default template:
```
#highlight
Readwise Location::
Topics::
Notes::
```
Note the indentation above. The highlight text is shown at the top level, with the default #highlight tag inline with it. Nested under the highlight text are the location information (e.g. page number, link back to article/tweet, etc.) and any notes or tags attached to that highlight, if they exist.
Why might you want to customize the highlight text? For one, if you'd just prefer to change the default formatting, for example by putting notes inline or at the parent level.
Here's an example of how you might add the highlight date as a new field:
```
#highlight
Readwise Location::
Topics::
Notes::
Date Highlighted::
```
There is, of course, much more you can do with this by using the [Jinja2 templating language](https://jinja.palletsprojects.com/en/2.11.x/).
### Metadata
Below the highlights template, you'll find a series of toggles that allow you to enable/disable and rename the fields that Readwise will create for each document node. (Note that these are the _document_-level properties, not the _highlight_-level properties.)
The default settings look like this:
You can enable or disable any of these fields simply by clicking the corresponding toggle on or off. In the fields to the right, you can customize what the titles of the fields will be when exported to Tana. For example, if you already have a field called "Title" that you use as a different part of your Tana workflow, you could change "Title" here to be "Document Title" instead.
How does the Readwise to Workflowy export integration work?
## Setting up the Workflowy integration
To get started with syncing your highlights to Workflowy, click **Connect** on the Workflowy option from the [Readwise export page](https://readwise.io/export).
If you're not already signed in to Workflowy, this will prompt you to log in to your account. You'll then be directed to the [Readwise integration settings inside of Workflowy](https://workflowy.com/integrations/readwise/).
Follow the provided link to copy your [Readwise access token](https://readwise.io/access_token), then paste it into the field in the Workflowy settings. Click **Connect to Readwise**.
Your Readwise highlights will now begin syncing to your Workflowy account, and will continue to do so automatically once per hour. If you'd like to prompt an immediate sync, click **Sync now**.
Once the sync is complete, you'll find your Readwise highlights under a "Readwise" bullet on your Workflowy Home page. Each document will be listed below that bullet, with nested bullets for each individual highlight.
Documents will be tagged with their respective types (e.g. article, book, etc), allowing you to filter and organize your highlights.
## Workflowy integration FAQs
### What happens when I take new highlights? Will those automatically sync with Workflowy?
Yes! If the highlight is from a _new_ document, a new bullet will be made under the Readwise bullet in Workflowy. If the highlight is from an _existing_ document, the highlight will be added as a new nested bullet under the existing document.
Certain services such as Amazon Kindle, Instapaper, and Pocket only synchronize with Readwise a few times a day. For this reason, the highlight may not immediately appear in either Readwise or Workflowy. If you need to sync sooner, you should first force a manual resync in Readwise of the highlight source and then initiate a sync in Workflowy.
### How do I trigger a new sync to Workflowy?
You can trigger a manual sync at any time by clicking **Sync now** on the [Readwise integration settings page in Workflowy](https://workflowy.com/integrations/readwise/).
### Can I edit the name of a document in Workflowy?
Yes! You can edit a document's title in Workflowy and the sync will still be connected to the document in Readwise. If you make any new highlights in the document, they'll still be synced to the re-named document in Workflowy.
### Can I edit the text of a highlight in Workflowy?
Yes! You can edit the text of a highlight as you wish and the Readwise integration will not overwrite any changes you've made in Workflowy.
### How do I reset the integration so I can start over fresh?
If you ever want to "reset" the Readwise integration to Workflowy and start from scratch, you can do so by deleting the Readwise bullet in Workflowy. Then trigger a new sync to Workflowy by clicking **Sync now** on the [Readwise integration settings page in Workflowy](https://workflowy.com/integrations/readwise/).
All of your content will be freshly synced to a brand new Readwise bullet on your Workflowy Home page.
This integration was developed by the Workflowy team using the Readwise API, so our ability to troubleshoot it will be limited. If you encounter any issues with the export, please reach out to [support@workflowy.com](mailto:support@workflowy.com) for help.
General
## How do I use Readwise if I don't have that many highlights yet?
While you're building up your own collection of digital highlights, you can "supplement" your Daily Review with popular highlights from books you've read using [Supplemental Highlights](https://readwise.io/supp\_library). (This is also great for integrating audiobooks or physical books into your Daily Review!)
Supplemental highlights are generated automatically from the most popular sections of books in Readwise.
Although these supplemental highlights are obviously not quite the same as your own personal highlights, reviewing them can be surprisingly effective nonetheless!
## Why are my highlights out of order?
Certain reading platforms such as Pocket do not have a "location" identifier. Accordingly, those highlights are sorted in Readwise by the date and time that the highlights were created. If having the highlights in the right order is important to you, be mindful to highlight in the order of top to bottom (i.e. no jumping back to highlight earlier in the article).
## How do I add a new allowed email address to send documents to my Readwise account?
You can import certain documents (such as My Clippings.txt, Apple Books HTML exports, PDFs, and more) to your Readwise account by sending an email to [add@readwise.io](mailto:add@readwise.io) with the document attached. This will import the highlights from the documents.
The emails must be coming from addresses that are allowed in your account. This ensures that the documents and highlights you send are connected to your Readwise account and can be uploaded properly.
When you create your Readwise account, the email address you use to sign up will automatically be added as an allowed email. To add additional emails, go to [https://readwise.io/import/email](https://readwise.io/import/email) and scroll down to the **Associated Email Addresses** section.
1. **Add another email address:** To add a new email, enter it into this field and click the “Add” button.
2. **Make primary:** This will be listed next to any email that is not currently the primary email, i.e. the email you use to log in and receive Daily Digests.
3. **Remove:** Removes the email from your allowed addresses.
Once you have added an email to this list, you’ll be able to send and forward documents to your Readwise account using the associated email account.
## Does Readwise have an API?
Yes! You can find our documentation on writing highlights to Readwise for a user using the following link: [http://readwise.io/api\_deets](http://readwise.io/api\_deets).
If you have any questions about the API or its documentation, please don't hesitate to shoot them over to [hello@readwise.io](mailto:hello@readwise.io)!
Readwise Discord Bot
## How can I set up the Readwise Discord bot for my server?
The [Readwise Discord bot](https://readwise.gg/) enables server members to easily save messages—including links, images, and even threaded conversations—to their Readwise Library to review later.
Additionally, this bot will generate a sleek, auto-updating RSS feed of links shared in the server, allowing members to stay up-to-date on the biggest convos of the week and easily jump back into the server to discuss. **This bot is 100% free and requires no Readwise subscription to enjoy.**
## What server permissions does the bot need to be enabled?
In order to properly function, the Readwise Discord Bot requires _all_ the following permissions:
### Installing the Bot in Your Server
Head to [readwise.gg](https://readwise.gg/) to install the Readwise bot on your server. Follow the setup instructions via Discord DMs to get started.
### Setting Up Your Server's RSS Feed
By default, the Readwise bot will index the past 50 links per _public_ channel and add them to your RSS feed. If you want links shared in private channels to be indexed in your RSS feed, you can add the bot to those channels either by assigning the bot an additional server role with access to those private channels OR right-clicking on the private channel, clicking Edit Channel, navigating to Permissions, and adding the bot as a member.
### Rejecting Links
The Readwise bot will automatically create two new channels in your server called #accepted-links and #rejected-links.
If you spot a link in your server that you don't want indexed in your RSS feed, simply navigate to #accepted-links, locate the link, and react ❌ to reject it one time from the feed.
### Excluding Certain Domains From Your RSS Feed
If you want to exclude links from a specific domain entirely, follow the rejection steps above, and then react ⛔️ under the confirmation message to automatically reject links from that domain going forward.
If you ever want to make an exception to this rule, you can locate the link in #rejected-links and react with ✅ to include it in your feed.
The best way to contact us is by emailing [hello@readwise.io](mailto:hello@readwise.io). Our Twitter account is very noisy so we’re likely to miss you if you tweet at us.
## How can members of my server use the Discord bot?
The [Readwise Discord bot](http://readwise.gg/) enables server members to easily save messages—including links, images, and even threaded conversations—to their Readwise Library for later.
This bot also creates a sleek, auto-updating RSS feed of links shared in the server, allowing you to stay up-to-date on interesting links shared in your communities and easily jump back in to discuss. **This bot is 100% free and requires no Readwise subscription to enjoy.**
### Save messages inside Discord
To save a message to your private DMs for easy future reference, simply react with a bookmark emoji 🔖 in a server where the Readwise bot is installed. It will automatically DM you a copy of the message for safekeeping. This is completely free.
### Save messages to Readwise
You can also optionally save any message to your Readwise account by using the floppy disk emoji 💾 instead of the bookmark.
### Add tags to saved messages
If you want to add a tag (in Readwise) to a saved message, you can reply to that message with a word beginning with a period `.` (the same as an [inline tag](https://blog.readwise.io/tag-your-highlights-while-you-read/) with any service that Readwise supports). For example, `.ai` will be turned into an AI tag.
### Add notes to saved messages
If you want to add a note in Readwise to a saved message, you can reply to that message via DM with your note.
### Take notes with Quick Passages
If you want to jot down a quick passage in your Readwise account that will be resurfaced like any other highlight, you can send a DM to the Readwise bot. The message will be added to your default Quick Passages “book” in Readwise.
### Where to find saved messages in Readwise
Once you’ve connected your Readwise account, you can find your saved Discord messages in the [Tweets](https://readwise.io/tweets) section of your [Readwise Dashboard](https://readwise.io/dashboard).
### Find your server’s custom feed aggregator
Use the slash command `/url` in any server where the Readwise bot is installed to find the link to that server's Hacker News link aggregator.
### Find your server’s RSS feed link
Use the slash command `/rss` in any server where the Readwise bot is installed to find the link to that server's RSS feed. When opened in a browser, this won't look like much, but if you add that RSS link to your favorite feed aggregator, you'll see your favorite Discord links come through.
**Pro tip:** If you're a [Reader user](https://readwise.io/read), you can add this URL to your Feed so you can get important Discord conversations piped directly into your favorite reading app 😉
### Use the Readwise Bot in other servers
You can click the bot's name in a server where it's installed and select `Add to Server`, or you can install the Readwise Bot via [https://readwise.gg/](https://readwise.gg/).
## How can I get help, send feedback, or report bugs?
The best way to contact us is by emailing [hello@readwise.io](mailto:hello@readwise.io). Our Twitter account is very noisy so we’re likely to miss you if you tweet at us.
Finding Your Highlights
One of the greatest powers that comes with using Readwise is the ability to think, "Hey, I'm pretty sure I read something about that once," and be able to find the exact quote within minutes.
Whether you're writing a thesis or just trying to win an argument with a family member, citing your sources can make a big difference.
## Browse by source
Maybe you can't remember any of the words in the quote, but you know it was in the book you finished last week. Maybe you don't even have a specific quote in mind, you just know that an article you read the other day had some really good ideas about a certain topic.
To find a specific source on web, click into the **Browse** tab and select the appropriate category. (Or choose "Everything" to see all of your source documents in one place.)
On mobile, go to the **Search** tab and select the appropriate category under the *Browse your content* section.
## Search by keyword
If you've got a word or two that you know are in the passage you're looking for, a keyword search can get you to the quote even faster.
On web, click the magnifying glass icon in the top right to open the search field. Type your keywords and hit `enter` to access the search results page.
Much like Google, Readwise's search results can be accessed using a **URL parameter** to query the page: `readwise.io/search?q={query}`
For example: [readwise.io/search?q=never+gonna+give+you+up](https://readwise.io/search?q=never+gonna+give+you+up). (Your browser should convert any spaces to `+`, so you don't need to type those into your query.)
You can use this knowledge to set up a site search shortcut in browsers like [Google Chrome](https://support.google.com/chrome/answer/95426) or [Arc](https://resources.arc.net/hc/en-us/articles/20855018192791-Site-Search-Directly-Search-any-Website), a [Quick Link in Raycast](https://www.raycast.com/core-features/quicklinks), and more!
On mobile, go to the **Search** tab and use the text field at the top of the page to enter your keywords.
Highlight text and document metadata are both queried for search keywords, and results with matches in both places will be ranked above results that only match one.
An example: `taleb harvard` will return highlights that have "Taleb" in the author field and include the word “Harvard” in the highlight text before highlights that just mention one of those terms.
## Chat with your highlights
If your memory of the passage you're looking for is just too vague to search, [try the **Chat** feature instead](/readwise/guides/chat-with-highlights)! You might be surprised how quickly you can surface a specific piece of text from a psychology book with an obscure question like, "Have I ever taken a highlight about how the brain works?"
Mobile Apps
## Does Readwise have an iOS mobile app?
Yes! Readwise has an iOS app [available in the App Store](https://readwise.app.link/6VY4GcGnIgb).
## Does Readwise have an Android App?
Yes! Readwise has an Android app [available in the Google Play Store](https://readwise.app.link/jRPHsdEnIgb).
## Can I turn off Daily Review emails and still get iOS notifications?
Yes! You can set your Email Frequency to "Never" on your [email preferences page](https://readwise.io/configure), and you'll still get your Daily Reviews in the app. You'll also continue to receive notifications as long as you've enabled push notifications for the Readwise app in your device settings.
The notification should arrive within an hour after the "email send time" set in your email preferences. So, for example, if you want the iOS notification at 10 AM, you can set the email time to 9 AM in your preferences.
## How can I add the Readwise widget to my iPhone home screen?
To get started, you'll need to download the [Readwise iOS app](https://readwise.app.link/6VY4GcGnIgb). If you already have the Readwise app downloaded, you just need to make sure that it's updated beyond version 2.7.2.
### How do I add the widget to my home screen?
Long press anywhere on your unlocked iPhone screen, tap the `+` symbol in the upper right-hand corner, select Readwise, and tap Add Widget on the widget of your choosing.
### How does the widget work?
If you've already completed your Daily Review, the widget displays a random highlight that rotates every 5 minutes throughout the day. If you haven't yet finished your Daily Review, it shows the first review highlight alongside a helpful prompt.
### What do I do if the widget is blank or doesn't appear at all?
Make sure that your iOS is updated beyond version 14.5.1. Shutting down the phone for 10 seconds and then turning it back on can also help.
## Why did push notifications stop in the iOS Readwise app?
Some users have reported that after getting a new iPhone or iPad and restoring a backup, they stop receiving push notifications from the iOS Readwise app. We're investigating the issue, but in the meantime, there is a fix:
* Rather than deleting the app from your Home Screen and then reinstalling, go to Settings → General → iPhone Storage → Readwise
* Once there, tap "Delete App" (as shown below)
* Once deleted, reinstall the Readwise app from the App Store
* After reinstalling, re-enable notifications
You should receive push notifications from the Readwise app within one hour after the [send time of your Daily Review email](https://readwise.io/configure).
Reviewing Your Highlights
## Can I customize how often documents appear in my Daily Review?
Yes! This is called Frequency Tuning, and there are a few ways you can adjust it.
### From your account settings
You can customize how often any document (or document type) appears in your Daily Review by editing your [Frequency Tuning](https://readwise.io/configure/tune/books) (Account > Configure Reviews > Frequency Tuning).
1. Select a source type to adjust, e.g. books, articles, podcasts, supplemental books, etc.
2. Edit the frequency of all documents from that source type.
3. Edit the frequency of individual documents.
### From your Library
You can adjust the frequency of any individual document from your [Library](https://readwise.io/library) by clicking the down arrow to the far right of the item in the list.
### From your Daily Review
You can adjust the frequency of a document when it appears in your Daily Review by clicking into the down arrow menu in the top right of the card.
If you have 500 total highlights in your account and a single document contains 100 highlights, there's a 20% chance your Daily Review will contain a highlight from that book. Meanwhile, a document with only 5 highlights would have a 1% chance of appearing. For this reason, you may want to tune _down_ a document with many highlights and/or tune _up_ a document with only a few. It’s not uncommon for users to need to tweak their settings a few times before getting it to suit their preference.
Each time a highlight is shown, its probability of resurfacing is significantly decreased. So, while it's possible that you might see the same highlight twice in rapid succession before having seen all your highlights at least once, it would be fairly unlikely!
## I want to review my highlights while I'm doing something else. Can I listen to my Daily Review?
Yes! To start audio playback of your Daily Review, open the review and then tap or click the play icon in the top right.
You can change the speed of playback, jump forward or backward 15 seconds, or pause the audio from the playback navigation bar at the bottom of the screen.
To stop playback on web or desktop, click the **X** at the far right of the playback bar.
To stop playback on mobile, tap the square icon in the top right.
Use this feature in conjunction with [Themed Reviews](/readwise/guides/themed-reviews) to create your own highlight-based podcast about a particular topic.
## How do I return to the original article where I took a highlight?
You can return to the original source of any highlight by clicking or tapping the down-arrow in the upper right corner of any highlight and selecting `View in [Source]`.
## Can I find related highlights from my Daily Review?
Yes! You can find other highlights that are similar to a highlight in your Daily Review by clicking the overlapping speech bubble icon in the top right of your Daily Review.
This will open a new conversation in the [Chat With Highlights](/readwise/guides/chat-with-highlights) feature and autofill a prompt that will search for highlights that are similar to the selected highlight.
## What's the difference between Scroll Mode and Review Mode?
When using Readwise on web, there are two ways to view any collection of highlights: **Review Mode** or **Scroll Mode**.
### Review Mode
Review Mode displays the highlights one at a time, so you can review them individually before clicking through to the next.
This is the default for your Daily Review, or for any Themed Reviews, but you can switch to this view while viewing a single document's highlights by clicking the grid icon in the top right corner.
Review Mode prioritizes highlights that haven't been processed, so if you've already used Review Mode to view some of the highlights or if they've appeared in your Daily Review, those will be skipped until you review the rest of the document's highlights.
Note that using the arrow icons (or the left and right arrows on your keyboard) to navigate will count as "skipping" the highlight, so it won't be processed. To process the highlight, use either the **Discard** or **Keep** button.
### Scroll Mode
Scroll Mode displays all of the collection's highlights on a single page.
This is the default when viewing highlights from a single document (book, article, etc), but you can switch to this view during your Daily Review by clicking the list icon in the top right to see the full contents of your review on one page.
When using this mode for your Daily Review or a Themed Review, each highlight will still allow you to perform all the usual actions: Discard, Master, Feedback, and Keep.
## Can I use keyboard shortcuts while reviewing highlights?
Keyboard shortcuts are the best. Here's a list of shortcuts you can use in the Readwise web app:
---
* `←`
* Previous highlight
---
* `→`
* Next highlight
---
* `ENTER`
* Done (Mark highlight as read and move to next)
---
* `t`
* Tag
---
* `m`
* Master
---
* `` ` ``
* Feedback (spaced repetition)
---
* `f`
* Favorite
---
* `d`
* Discard
---
* `e`
* Edit
---
* `n`
* Note
---
* `s`
* Share
---
* `cc`
* Copy highlight to clipboard
---
* `ll`
* Switch to card view / switch to list view (individual document review)
## Will deleting a highlight in Readwise delete the original or vice versa?
If you delete (or discard) a highlight in Readwise, the highlight in the original source will not be deleted. This includes Amazon Kindle, Apple Books, Instapaper, Pocket, and other integrations. Similarly, if you delete the highlight in the original source, the highlight will not be deleted in Readwise.
The one exception is if you delete a highlight from Amazon Kindle and then force a full refresh. In that case, any previously imported but now deleted highlights in Kindle will also be deleted from your Readwise account.
## Can I add formatting to my highlights, like bold or italics?
You can use markdown formatting to customize how your highlights look, and to add emphasis to certain parts of a passage.
For example, perhaps a single line really struck you but it didn't make sense without its context, so you highlighted the entire paragraph. To call attention to the line you really wanted to keep, you can use markdown to add a **hyperhighlight** using two underscores on either side of the text, like so: `__Really awesome line of text.__`
You can also use markdown to italicize or bold parts of the text. This can be helpful to fix highlights that imported from a source without the original formatting from the book, or when you're [manually entering passages from paper books](/readwise/docs/importing-highlights/ocr).
Markdown formatting can be particularly nice when creating Q&A [Mastery flashcards](/readwise/guides/mastery). For example, you might want to **bold** a key term in the question, or highlight an example sentence in the answer.
If you're using Reader, you can even automate the formatting of your flashcards by using the `.qa` action tag with a custom prompt in Ghostreader, like the [Vocab Flashcard example](/reader/guides/ghostreader/prompt-library#vocab-flashcard) in our Prompt Library!
### Markdown syntax reference
* Markdown Syntax
* Text Effect
* Visual Example
---
* `__text__`
* Highlight the text
*
---
* `*text*`
* Italicize the text
*
---
* `**text**`
* Bold the text
*
## Why can't I permanently delete highlights?
The reason that Readwise only uses a soft _Discard_ rather than a hard _Delete_ might seem odd at first, but it's fairly intuitive once you understand the rationale:
Readwise synchronizes your highlights from a variety of sources. For instance, if you hard-deleted a Kindle highlight in Readwise but not in the original Kindle source, then the next time Readwise is synced with Kindle, Readwise would see the deleted highlight as new. The previously deleted highlight would then be re-imported to Readwise, causing it to return from the dead like a frustrating zombie highlight.
We could always just delete the highlight from the frontend in Readwise and save a copy in the backend to compare against future syncs, but that would be misleading and frustrate users who want to recover an accidentally deleted highlight.
If permanently annihilating a highlight is important to you, then we advise you to do so in the original source. Then refresh those highlights within Readwise via the following steps:
1. Select the **down arrow** next to the book/article to open the document options
2. Select **Refresh Highlights**
3. Re-sync highlights from source here: [readwise.io/welcome/sync?refresh=true](http://readwise.io/welcome/sync?refresh=true)
The above directions don't apply to manually entered highlights or to those taken with the Readwise web clipper. Your options are to delete the book/article and re-enter all your highlights while leaving out the ones you want to delete permanently, or to just discard the highlight.
## Why is my Daily Review empty? What is the Highlight Quality Filter?
The **Highlight Quality Filter** is a feature that checks for "low quality" highlights, such as sentence fragments, and blocks them from being included in Daily Reviews. It's enabled by default, but there may be some instances where you might prefer to turn it off.
For example, some users (especially those whose highlights are primarily in character-based writing systems such as Hanzi, Kanji, or Arabic) might see an error on their Daily Review page that says: "This review doesn't have any highlights anymore: perhaps you deleted or changed them since it was created?"
This can happen because the quality filter is mistaking shorter sentences (containing a smaller number of characters than expected) as fragments and hiding them.
This message can also appear if you don't have any highlights available to review. If you're low on highlights in your account, check out our many [import options](../importing-highlights) or try adding some [Supplemental Books](../general/how-do-i-use-readwise-if-i-dont-have-that-many-highlights-yet.md) to your account!
To turn off the Highlight Quality Filter, go to the account menu, click **Configure Reviews**, then select the [Review Settings](https://readwise.io/configure/review) tab. The Highlight Quality Filter is the last option on the page.
## How can I create custom reviews of highlights (Themed Reviews)?
While you can customize which documents are included in your Daily Review from the [Configure Frequency Tuning page](https://readwise.io/configure/tune/books), you can also create customized reviews for specific topics using our Themed Reviews feature.
Using Themed Reviews, you can build sets of highlights based on any combination of books, articles, tweets, notes, and [tags](https://blog.readwise.io/tag-your-highlights-while-you-read/), separate from your Daily Review. You can also optimize when your Themed Review is delivered — whether that be on specific days of the week or even just once a month.
You can access the feature by scrolling to the bottom of your Dashboard and selecting [Themed Reviews](https://readwise.io/themed\_reviews).
Learn more about this feature in our [Themed Review feature guide](/readwise/guides/themed-reviews)!
## How does the Readwise spaced repetition algorithm work (Mastery)?
The Readwise spaced repetition algorithm (Mastery) is admittedly a bit of a black box compared to powerful spaced repetition software (SRS) such as Anki or SuperMemo. This is because we're trying to create a spaced repetition alternative that is extremely user-friendly, compared to the existing offerings that have notoriously steep learning curves.
That said, here are the details behind the Readwise spaced repetition algorithm:
* We use a decaying algorithm based on a recall probability half-life rather than a date-based algorithm as found in Anki.
* The initial half-life of a Mastery `soon` is 7 days. `Later` is 14 days. `Someday` is 28 days.
* Once a highlight recall probability decays to 50% or lower, it becomes a candidate to be resurfaced in the latter half of your Daily Review.
If you have a lot of Mastery flashcards that are candidates to be resurfaced (that is, their probability of recall is calculated to be less than 50%), then those with the lowest recall probability will be resurfaced in your Daily Review.
You can see all your Mastery flashcards, their half-lives, and their recall probabilities here: [readwise.io/mastery](https://readwise.io/mastery).
## Can I turn off the email alerts for my Daily Review?
Yes! You can set your Email Frequency to "Never" on your [email preferences page](https://readwise.io/configure). You'll still be able to access your Daily Reviews in the app or from [the web dashboard](https://readwise.io/dashboard).
## Why am I still getting highlight emails even though I turned them off?
If you've created any [Themed Reviews](/readwise/guides/themed-reviews), the email frequency for those is edited separate from the Daily Review.
You can turn off these emails from [the Themed Reviews page](https://readwise.io/themed_reviews) by clicking the review and then toggling **Send Emails** to OFF.
You will still see your Themed Reviews appear on your Readwise dashboard at the specified frequency.
Import Highlights to Readwise
Readwise supports importing highlights from a variety of reading platforms, including:
Once you've signed up for a Readwise account, just head to the [Import section](https://readwise.io/welcome/sync) of your Readwise account to import your highlights.
We're constantly adding more integrations! To learn more or request a new source, feel free to reach out to us at [hello@readwise.io](mailto:hello@readwise.io).
## How can I manually import my highlight collection to Readwise?
Many users of Readwise have kept their own collections of highlights and notes in various formats, whether it be an Excel spreadsheet, a Word document, or an ever-growing Apple Note.
There are a few ways to bring your manually-curated collection into Readwise.
### CSV Upload
To import highlights in bulk, you can upload a CSV file. For instructions and information on how the file should be formatted, see the [import page](https://readwise.io/import_bulk).
If your file is in another format—such as a TXT, Numbers file, etc.—you'll have to convert the file to CSV before uploading.
### Freeform Input
You can add highlights individually using the [Freeform Input tool](https://readwise.io/import_freeform). This is great for collecting highlights that might be scattered across various sources, or even for capturing the witticisms of any particularly erudite friends.
### Scan via App (OCR)
If you've highlighted physical sources—such as books, magazines, newspapers, etc.—you can use the mobile app to take a picture of the page and scan in the highlight. You can learn more about the feature here: [How do I import highlights from physical or paper books?](/readwise/docs/importing-highlights/ocr)
Import from Apple Books
## How do I import highlights from Apple Books?
It's much harder to import your highlights from Apple Books (iBooks) than it is from other e-reading platforms such as Amazon Kindle, but that's okay. There are still two ways to get your Apple Books highlights into Readwise.
First, you can download and install the Readwise Mac tool on your computer by following the instructions here: [Readwise Mac Tool](https://readwise.io/ibooks).
Second, you can email highlights to Readwise directly from the Books app on your iPhone or iPad by following the instructions below.
## How do I import Apple Books highlights from my iPhone/iPad?
To import highlights from Apple Books on your iPhone or iPad:
1. Open your book in the Apple Books app
2. Tap into the actions menu in the bottom right
3. Select "Bookmarks & Highlights"
4. Switch to the "Highlights" tab
5. Tap Select in the top left
6. Select the highlights you'd like to send to Readwise
7. Tap the Share icon, then select your email app
8. Send to [add@readwise.io](mailto:add@readwise.io)
These highlights will then be automatically imported into your Readwise account!
## Can I import highlights from PDFs read in Apple Books?
Unfortunately, Apple Books doesn't create "real" highlights on PDFs (i.e. according to the PDF spec), so you'll need to use a different app to get these highlights into Readwise. You can check out our list of [previously vetted software](/readwise/docs/importing-highlights/pdf#what-pdf-reader-apps-work-with-readwise) that will allow you to import your PDF highlights into Readwise.
Alternatively, you can [upload the PDF into the Reader app](/reader/docs/faqs/adding-new-content#how-do-i-upload-files-to-reader) to read and highlight. This will remove the step of needing to email the PDF to Readwise, since any highlights you make in Reader will automatically sync to your Readwise library.
## What do I do if the Mac tool isn't importing my Apple Book highlights?
### Persistent spinning wheel or error
If this happens, there are a couple of possible ways to resolve the error.
- **Resync the Mac tool**
- *Log out* of the Mac tool.
- Select *Resync* to log back in and to run the sync again.
- **Open Apple Books on your computer**
- If you've never opened the Apple Books app on your computer (e.g. you only read on your phone or tablet), the database may not be synced and thus the Mac tool won't be able to find any of your highlights.
- Launch the Mac app at least once to force a sync, wait for your most recent data to appear, then try the Mac tool again.
### Mac tool caveats
- The Mac tool only works for Big Sur and newer at this time. If you can't or don't want to upgrade the OS, then you can use the instructions above to import highlights from iPhone or iPad.
- The Mac tool cannot import highlights made on PDFs as Apple Books doesn't follow the PDF spec to create "real" highlights. You can use the instructions above to import highlights from PDFs.
Import from Email
## How do I import highlights by emailing them to Readwise?
You can import highlights from various sources by emailing them as attachments to **add@readwise.io**.
At the moment, we support the following sources:
* [Kindle _My Clippings.txt_](/readwise/docs/importing-highlights/kindle#how-do-i-import-my-clippings-txt-to-readwise) (file stored on your Kindle device accessible via USB)
* [Kindle HTML export](/readwise/docs/importing-highlights/kindle#kindle-apps-email) (for documents on Kindle iOS, Android, or Fire)
* [Apple Books HTML export](/readwise/docs/importing-highlights/apple-books#how-do-i-import-apple-books-highlights-from-my-i-phone-i-pad) (as an alternative to the Readwise Mac tool)
* [Scribd export](/readwise/docs/importing-highlights/everand)
* [Highlighted PDFs](/readwise/docs/importing-highlights/pdf)
Whenever you email a supported file above from [an email address associated with your Readwise account](https://readwise.io/import/email), it'll be automatically imported into your account.
Import from Everand (Scribd)
Scribd doesn't currently offer a native option to export highlights, but here's a workaround that allows you to export highlights from a single book at a time to import into Readwise.
Note: This method requires the Google Chrome web browser and may result in some highlights being truncated. This is a limitation of how the Scribd reading interface is formatted.
1. Go to [Scribd](https://www.scribd.com/) or [Everand](https://www.everand.com/) and open the book that you'd like to get the highlights from.
2. Click the **kebab icon (3 vertical dots)** in the right-hand corner, then click into **Notes & Bookmarks**:
3. With the pop-up open, select **View** > **Developer** > **Developer Tools**:
4. Select **Console** from the developer view and input the following script next to the `>` symbol, then press **Enter**. (You may need to type "allow paste" before it will allow you to paste the script in.)
```javascript
var annotations = document.querySelector('.annotations');
var notesParagraphs = Array.from(annotations.querySelectorAll('p'));
var notesText = notesParagraphs.map((paragraph) => `${paragraph.innerHTML}
`).join('');var win = window.open("", "Title", "toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width=780,height=200,top="+(screen.height-400)+",left="+(screen.width-840));
win.document.body.innerHTML = `${notesText}
`;
```
5. A new window will open that contains all the highlights as plain text, and you can copy/paste the highlights to import them into Readwise with any of the following tools:
* [CSV Import](https://readwise.io/import\_bulk)
* [Freeform Input](https://readwise.io/import\_freeform)
* [PDF Import](/readwise/docs/importing-highlights/)
Import from Feedly
## How do I import highlights from Feedly?
Here are directions on how to integrate your Feedly account with Readwise:
1. Go to your Readwise [dashboard](https://readwise.io/dashboard) > [Import](https://readwise.io/welcome/sync) > [Feedly](https://cloud.feedly.com/v3/auth/auth?client\_id=readwise\&redirect\_uri=https%3A%2F%2Freadwise.io%2Ffeedly%2Fcallback\&scope=https%3A%2F%2Fcloud.feedly.com%2Fsubscriptions\&response\_type=code\&state=).
2. Log into your Feedly account:
3. Once successfully connected, your highlights will automatically be imported into Readwise!
Connect Readwise with Goodreads
If you're just getting started with Readwise and don't have many highlights of your own, [Supplemental Highlights](/readwise/docs/faqs#how-do-i-use-readwise-if-i-dont-have-that-many-highlights-yet) are a great way to fill your Library with the wisdom of books you've read in the past. But remembering what books you've read and manually entering them into your [Supplemental Books](https://readwise.io/supp\_library) can be a hassle.
If you've ever used Goodreads to track your reading, you can make use of that data to fill out your Supplemental Books automatically by [connecting your Goodreads account](http://readwise.io/goodreads) to Readwise.
## How do I connect my Goodreads account to Readwise?
To get started, go to the [import integrations page](https://readwise.io/welcome/sync), find the Goodreads option, and click **Connect**.
If you're not currently logged in to your Goodreads account, this will prompt you to enter your login information.
The integration will look at each book on your **Read** shelf and check to see if Readwise has any Supplemental Highlights for that book. Any books that do have Supplemental Highlights will be added to your Supplemental Books.
Once you've set up the integration, you'll be able to see the books you've read in your Readwise Library and begin to see popular highlights from your Goodreads books in your Daily Review.
## Does the Goodreads integration automatically update with new books?
Yes! Whenever you mark a new book as **Read** on Goodreads, Readwise will check for Supplemental Highlights and add the book to your Library.
## Why am I seeing duplicated books from my Goodreads account?
Readwise treats Supplemental Books as separate entities from books you've added from other sources (or manually). If you made highlights while reading the book using another source connected to Readwise (e.g. Reader, Kindle, Kobo, etc.) and then marked the book as **Read** on Goodreads, you may see two versions of the book in your Readwise Library: one in [Books](https://readwise.io/books) with the highlights you took, and one in [Supplemental Books](https://readwise.io/supp\_library) with popular highlights.
You can remove the Supplemental Books version by clicking into the book details and selecting **Delete book**.
Import from Google play Books
## How do I import highlights from Google Play Books?
It's a little tricky to get set up, but you can import your Google Play Books highlights into Readwise by following the steps below.
1. Make sure your Google Play Books account is configured to "Save notes, highlights, and bookmarks in Google Drive" (see the section entitled "Turn on notes saving" on Google's help page here: [Use & download bookmarks, notes, highlights, definitions, & translations](https://support.google.com/googleplay/answer/3165868?co=GENIE.Platform%3DAndroid\&hl=en\&oco=0))
2. Once this is properly configured, Google Play Books will start generating a Google Doc for each book containing your highlights:
3. Once you've got this working, open the Google Doc for the book you wish to import into Readwise.
4. Select File > Email > Email as attachment:
5. In the To field, enter **add@readwise.io**:
6. In the format dropdown initially set to PDF by default, select HTML instead:
7. Click Send
That's it! You should get a confirmation email linking to your newly synced highlights in Readwise 🙌
Please note that the Google Play Books import feature is still experimental, so please let us know if you encounter any bugs or difficulties!
Import Highlights from Inoreader
Here are directions on how to integrate your Inoreader account with Readwise:
1. Go to [https://www.inoreader.com/all\_articles](https://www.inoreader.com/all\_articles)
2. Go to your **Preferences menu** in the top right-hand corner > **Preferences**
3. Select **Share, Save & Login**
4. Hover over the question mark icon and click on [**readwise.io/access\_token**](http://readwise.io/access\_token)
5. Select **Get Access Token** > **Copy to clipboard**
6. Go back to the Inoreader integration page, paste the token and select **Connect**
7. Get to highlighting! After text is highlighted, you can select the **marker icon** next to the highlight to add a comment, which will also import into Readwise.
You must be on the Inoreader Pro version to annotate/highlight and to sync with Readwise.
Import Highlights from Instapaper
To import your Instapaper highlights into Readwise, go to the [import integrations page](https://readwise.io/welcome/sync/) and click the Instapaper option.
This will open a page where you can log in to your Instapaper accout and grant it permission to share your data with Readwise.
Import from Amazon Kindle
You can import your Kindle highlights to Readwise by choosing the Kindle option on the [Import Highlights](https://readwise.io/welcome/sync) page of your Readwise account.
This will direct you to the page where you can install the [Readwise browser extension](#how-do-i-download-the-readwise-chrome-extension). Once you've installed the extension, you will be prompted to log in to your Amazon account.
Upon logging in, the extension will navigate to your [Kindle notebook](https://read.amazon.com/notebook) and begin syncing your highlights. You'll see a progress indicator as it syncs, followed by a confirmation page once the syncing process is complete.
If you read personal documents on your Kindle device or in a Kindle app, those highlights will not be automatically synced with Readwise. Amazon does not synchronize highlights of personal documents to the cloud the same way it does highlights of books purchased or borrowed through the Kindle store. You can use one of the [methods described below](#how-do-i-import-highlights-from-documents-i-sent-to-my-kindle).
## Does Readwise automatically sync new highlights I take on Kindle?
Yes! So long as you (1) use the Chrome or Firefox browser on your computer and (2) keep the Readwise browser extension installed, then Readwise will continue to automatically sync your Kindle highlights.
Occasionally, your browser will be logged out of the Kindle notebook page. If this happens, Readwise will display an orange dot on your Dashboard prompting you to log back in.
If Readwise notices that new Kindle highlights haven't been synced in the past 45 days, you'll receive an email reminding you to resync.
## How do I download the Readwise Chrome extension?
The Readwise Chrome extension is not publicly searchable in the Chrome Web Store because the authorization with Amazon doesn't work properly if you install the extension without first connecting your account to Readwise.
You can find the extension download link on the [Import](https://readwise.io/welcome/sync) page by selecting the Kindle option. You’ll then be prompted to install the extension from the Chrome Store.
## Does Readwise have access to my Amazon password?
No! In fact, Readwise couldn't access your Amazon password even if we wanted it to.
* When you sign in using Amazon's authentication, Readwise only receives your email address.
* When you sync your highlights with the Readwise browser extension, Readwise only has access to the subdomain read.amazon.com, which _never_ exposes your Amazon password — only your books and highlights.
## Some of my Kindle books and highlights aren't syncing. What do I do?
Here are some troubleshooting steps to sync all your Amazon Kindle highlights with Readwise.
### Check that Amazon has all your highlights
Confirm that all the books you've read and highlighted on Kindle appear on this website: [read.amazon.com/notebook](http://read.amazon.com/notebook). The highlights on this page are the highlights that will automatically sync with Readwise using the Readwise browser extension.
If the books are not there, then it means they're not syncing with your Amazon account. This could happen for a few reasons:
1. You did not take any highlights in the book.
2. Your Kindle has been offline since you took the highlights. Make sure your device is connected to the internet so it can sync.
3. You might be highlighting books or documents you didn't purchase from Amazon. These highlights will not be synced with your Amazon account, and you need to import those to Readwise using a different method. See here: [How do I import highlights from documents I sent to my Kindle?](#how-do-i-import-highlights-from-documents-i-sent-to-my-kindle)
### Resync your account
If the books are showing up on [read.amazon.com/notebook](http://read.amazon.com/notebook) but still not syncing with Readwise, try forcing a full resync with Readwise using this link: [Full Resync](http://readwise.io/welcome/sync?refresh=true).
### Disable ad blockers
If the full resync doesn't work, try disabling any ad blockers for the Amazon and Readwise websites.
If you try all these steps and are still encountering syncing issues, please reach out to us at [hello@readwise.io](mailto:hello@readwise.io) and we'll help you get them sorted ASAP!
## Why are my Kindle highlights truncated or showing ellipses?
Publishers require Amazon to place a "copyright export limit" on the amount of highlighted text that can be exported from a particular book. This limit varies form book to book but is typically around 10% to 20% of the text. Once you exceed this threshold, highlights from the book will be truncated.
You can see if this is happening to your highlights by visiting the [Kindle: Your Notes and Highlights](https://read.amazon.com/notebook) page and looking for the warning below:
Separately, Readwise automatically appends an ellipsis to any highlight fragment not beginning or ending with punctuation. We do this for aesthetic reasons and to let you know there was more to the sentence.
## How do I import highlights from documents I sent to my Kindle?
Your Kindle device or Kindle app only syncs highlights to the cloud from ebooks that you purchased directly from Amazon. You can see those highlights here: [Kindle: Your Notes and Highlights](http://read.amazon.com/notebook). These are the highlights that the Readwise extension can automatically synchronize for you. For highlights from books, articles, PDFs, and personal documents not purchased from Amazon, you can use a different technique to import your highlights to Readwise depending on whether you're reading on a Kindle device or a Kindle app.
### Kindle Device (My Clippings)
Every highlight you take on a Kindle device is added to a file called My Clippings.txt saved on the Kindle device. You can extract this My Clippings file by plugging it into your computer using a USB cable. Then you can [email](mailto:add@readwise.io) or [upload](https://readwise.io/import_clippings) it to Readwise and all those highlights will be imported into your Readwise account.
You can find more detailed instructions about this import in the section below: [How do I import My Clippings.txt to Readwise?](/readwise/docs/importing-highlights/kindle#how-do-i-import-my-clippings-txt-to-readwise)
### Kindle Apps (Email)
You can import highlights from non-Amazon documents sent to your Kindle app by following the steps below:
1. Launch the Kindle app on your device.
2. Open the document you want to import your highlights from.
3. Select the **Notebook** icon in the top right.
4. Tap the **Share** icon.
5. Select the **Email** option.
6. Email the highlights to **add@readwise.io**.
Readwise has advanced duplicate detection, so you don't need to worry about accidentally duplicating any previously imported highlights.
## How do I import My Clippings.txt to Readwise?
While many of your Kindle highlights can be imported using the Readwise browser extension, there are some exceptions. Most notably, the extension won't be able to import any highlights taken on documents not purchased from Amazon (i.e. sideloaded/emailed files). To get those highlights into your Readwise account, you'll need to use the _My Clippings.txt_ file.
There are two ways to import your _My Clippings.txt_ file, but before you can do either, you'll need to retrieve the file from your Kindle device.
To do so, plug your Kindle in to your desktop or laptop computer and locate the My Clippings.txt file as shown below:
Once you've retrieved the file, you can import it to Readwise in one of the following ways:
- Email the file as an attachment to [add@readwise.io](mailto:add@readwise.io). The file will automatically be processed and imported into your account.
- Upload the file via the [dashboard](https://readwise.io/dashboard) > [Import](https://readwise.io/welcome/sync) > [My Clippings.txt](https://readwise.io/import\_clippings).
Readwise has advanced duplication detection, so don't worry about deleting previously imported highlights from the *My Clippings.txt* file.
## How do I import Kindle highlights from an international Amazon domain?
The Readwise extension is designed to work with Kindle highlights synced to the cloud at [read.amazon.com/notebook](http://read.amazon.com/notebook). Sometimes, international Kindle users will find their highlights stored on a domain other than the **read.amazon.com**.
You can connect your international Amazon account to Readwise from the Amazon.com login page. Just note that if you *also* have an Amazon.com account, you'll need to make sure you’re logged out of that account prior to syncing.
To change the default language to English, click this [Amazon link](https://www.amazon.com/?language=en\_US) and then [re-sync your Kindle account](http://readwise.io/welcome/sync?refresh=true).
Most international domains will work fine with the Readwise extension, but currently **amazon.co.jp** (Japan) and **amazon.cn** (China) aren't compatible and trying to sync from those domains will fail.
## Can I sync a second Kindle account with Readwise?
Yes! You can sync a second Amazon Kindle account with Readwise. To do so, follow these steps:
1. Visit [read.amazon.com/notebook](http://read.amazon.com/notebook) and sign out of your first account using the link in the top right (where it says `Hello, [your name]`)
2. Sign in to your second Amazon account
3. Return to [readwise.io/sync](http://readwise.io/sync) and click the Amazon Kindle button
However, only *one* account can maintain a continuous, automatic sync with your Readwise account. Whichever account is currently logged in at [read.amazon.com/notebook](http://read.amazon.com/notebook) will be kept in sync by the Readwise browser extension.
## Can I jump to a highlight directly in the Kindle app?
Yes! If you're using Readwise on a desktop, you can jump directly to the highlight in the Kindle app for more context, provided you have the [Kindle app](https://www.amazon.com/kindle-dbs/fd/kcp) installed on your machine. All you need to do is click the downward chevron in the top right corner of each highlight and select **View in Kindle Desktop**, as shown below.
### Notes
* The newest Kindle app broke the location links, and not just for us—the location links at [https://read.amazon.com/notebook](https://read.amazon.com/notebook) won't open in the new app either.
- **Mac:** Previously, the workaround for this was to download the [Kindle Classic App](https://apps.apple.com/mg/app/kindle-classic/id405399194?mt=12?mt=12), but it seems that app has been removed from the App Store. If you still have the Classic app installed, you should still be able to use the location links, but otherwise you'll have to manually locate the highlight within the book.
- **Windows:** As of right now, clicking the "Download for PC & Mac" button on the [Kindle app download page](https://www.amazon.com/kindleapps) while using Windows will allow you to download the Classic app, which *does* still work with the location links.
* This feature doesn't currently work on mobile because the Kindle mobile apps don't allow for "deeplinking" the same way the desktop app does.
* There is a limitation with the desktop Kindle app where you can only jump to a highlight's location if the Kindle app is closed. If the app is already open, you'll need to close it before trying to jump to a new location from Readwise.
## Why don't my Kindle highlights have page numbers?
Due to the reflowable and reformattable nature of digital documents, Kindle books don't actually use page numbers and don't contain any information about their physical counterparts. The Kindle highlight data only includes the "Kindle location" number.
Import from Kobo
You can import your Kobo highlights to Readwise by choosing the [Kobo option](https://readwise.io/welcome/sync#kobo) on the Import Highlights page of your Readwise account.
Just like Kindle, only highlights made in books _purchased from Kobo_ are uploaded to their cloud services and can be automatically synced to Readwise. If you've made highlights in sideloaded documents, you'll need to plug your Kobo device into your computer and follow the steps to sync manually.
## Automatic Sync of Books Purchased from Kobo
On your first import, you will be prompted to provide your Kobo username and password. Please note that Kobo supports quite a few login options, but the Readwise integration only supports the Rakuten Kobo option (shown below). If you log into your Kobo account using a different method, the integration won't work.
Once connected, any highlights you take in Kobo should automatically sync with Readwise periodically throughout the day.
## Manual Import of Sideloaded Books
If you send documents to your Kobo device rather than purchasing them from the Kobo store, you'll need to manually extract those highlights from a database file on your Kobo device. Fortunately, a Readwise user has built a helpful tool called [October](https://utf9k.net/projects/october/) that works on almost all desktop operating systems (including Windows and MacOS) to automate this process. Once installed, you can simply plug your Kobo device into your computer and October will do the rest, including pulling the database file and uploading to Readwise.
## Beta Feedback
The Kobo import feature is still in beta, so please let us know if you encounter any bugs!
Import from Library Books
If you use a popular app that lets you borrow ebooks from your local library and read them on your digital devices, you can import highlights from them to Readwise. Depending on how you read your library books, you can use one of the following methods to import the highlights into Readwise.
## If you read on Kindle
If you read and highlight your library books on a Kindle device or in the Kindle app, the highlights will be automatically synchronized with Readwise as long as you have the Kindle integration configured.
All notes and highlights are preserved in your Kindle account after a library book loan ends. You can find your library book highlights that you've read with your Kindle device or in the Kindle app here: [https://read.amazon.com/notebook](https://read.amazon.com/notebook). (It's also best practice to make sure your highlights and notes are uploaded to Amazon prior to your library loan expiring.)
## If you read in the library app
If you read and highlight your library books in the same app where you loan them, [use this link](https://readwise.io/welcome/sync#libby) and follow the instructions on the screen. If the link isn't working for you, go to the [dashboard](https://readwise.io/dashboard) > [Import](https://readwise.io/welcome/sync) and click the "Library" integration.
### Exporting older highlights
Note that the library app integration will not import highlights from books older than a couple of weeks. To import highlights from older books, follow these instructions:
1. Navigate to the book in your app and select the **Reading Journey** button.
2. Open the **Actions** menu and select *Export reading data*.
3. Select the *Data* option to export in the JSON format.
4. On web, right click the generated JSON page in the web browser and select *Save as*. On mobile, open the generated page in your mobile browser, tap the share icon, and save the file.
5. Email the JSON file to [add@readwise.io](mailto:add@readwise.io) to import the highlights.
Import from Moon+ Reader
Android's most downloaded e-reading app includes a native highlight integration with Readwise. Highlights from ebooks read in Moon+ will automatically sync to Readwise!
## Configuration
1. Open a book > Tap the middle of the screen to open the menu tray
2. Select **3 dots** > Check box next to **Bookmarks** > Tap **bookmark icon**
3. Select **Settings** icon > Check box next to **Share new highlights and notes to Readwise automatically**
4. Select **Settings** icon next to the above > Select **information icon** > **Get Access Token** > copy token and paste into Moon+
## Notes
1. This is a global setting, so you won't have to complete these steps for every book.
2. Unfortunately, existing highlights won't sync, but you can delete/re-highlight your highlights to get them into Readwise.
3. Any notes you make will need to be added first if you'd like them to import into Readwise. Otherwise, you can always edit the highlights in Readwise at a later time to add your notes.
4. If you receive an error message, it's likely because you're offline. Make sure you're connected to data or WiFi > select bookmarks in the bottom right-hand corner > tap the 3 dots next to the date and time in upper left-hand corner > Share → Readwise
Import from Physical Books with OCR
## How can I use my device's camera to import highlights from physical or paper books?
If you have the Readwise [iOS app](https://readwise.app.link/6VY4GcGnIgb) or [Android app](https://readwise.app.link/jRPHsdEnIgb) installed, you can capture highlights from paper books using your phone's camera and optical character recognition (OCR).
To do this, go to the **Add Highlights** tab of the app and select **Add via photo**.
Take a photo of the book's page and use the selection handles to choose the passage you'd like to save, then tap the blue **Save** button. You'll have the option to edit the passage, in case the character recognition missed anything or you'd like to make any changes.
Tap **Next**, add the page number or any notes you'd like, then select or search for the book to save the highlight to.
You can also use screenshots or other photos already stored in your phone's camera roll by selecting the photo gallery option in the bottom right-hand corner.
## I don't have a device with a camera. How else can I add highlights from physical books?
In addition to OCR, you can manually type highlights into Readwise from the **Add Highlights** tab of the app by tapping **Add via text**.
This will allow you to manually type the passage you'd like to add, then use the same options as **Add via photo** for adding notes and selecting the book to save it to Readwise.
You can also add highlights manually on web using the [Freeform Input Tool](https://readwise.io/import\_freeform) or the [CSV upload](https://readwise.io/import_bulk).
Additionally, you can add the titles of paper books you've read and audiobooks you've listened to as [Supplemental Books](https://readwise.io/quick) to see popular highlights in your Daily Review.
Import from OReilly Learning
To import your highlights from the O'Reilly Learning platform into Readwise, first make sure you're logged into the [O'Reilly Learning website](https://learning.oreilly.com/). Click your profile icon, located in the top-right corner of the page. In the dropdown menu, select **Highlights**.
On the [Your Highlights page](https://learning.oreilly.com/highlights/), click the **Export all highlights** link below the page title. Your highlights will download as a CSV file.
Once you've downloaded the CSV file with your highlights, go to the [Readwise import page](https://readwise.io/welcome/sync) and locate the O'Reilly Learning card in the **Import & Upload** section.
Click **Import** to go to the [upload page](https://readwise.io/import/oreilly-learning/), then click **Upload a CSV file** and select the file you just downloaded (likely titled `oreilly-annotations.csv`).
Readwise can detect duplicate highlights and won't import any that have been added in a previous upload. If you've made new highlights in O'Reilly Learning and want to import them to Readwise, just repeat the steps above and only the new highlights will be added to your account.
Import from Other Sources
## Capture Highlights from Web Articles
There are a few ways you can capture highlights from web articles into Readwise.
### Readwise Reader (and other read-it-later apps)
You can use Readwise's own "read-it-later" app, [Reader](https://readwise.io/read), or others apps like Instapaper that can [integrate with your Readwise account](https://readwise.io/welcome/sync). As the name would suggest, read-it-later means you save articles you come across on the internet to read later within the app. This is our recommended approach to reading and highlighting web articles because nearly all such apps (1) clean up the article to make the reading experience more enjoyable, (2) include highlighting and annotating features, and (3) automatically sync with Readwise. Reader even shares a database with Readwise, which means your highlights will sync seamlessly with no setup required!
To save articles to Reader or to highlight articles on their original web pages, install the Readwise Reader browser extension:
* [Install on Chrome](https://chromewebstore.google.com/detail/readwise-highlighter/jjhefcfhmnkfeepcpnilbbkaadhngkbi)
* [Install on Firefox](https://addons.mozilla.org/en-CA/firefox/addon/readwise-highlighter/)
### Save Highlight to Readwise (desktop)
If you're reading something in Chrome or Firefox with the Readwise extension installed, you can quickly capture a highlight to Readwise by highlighting the desired text, right-clicking, and selecting Save Highlight to Readwise. This highlight will then appear in the Articles section of your Readwise Dashboard.
### Save Highlight to Readwise (iOS)
If you're reading something in Safari with the Readwise iOS app installed, you can quickly capture a highlight to Readwise by highlighting the desired text, selecting the share icon at the bottom of the tray on iPhone or top right on iPad (important: do not select Share in the popover), and selecting Save Highlight to Readwise. This highlight will then appear in the Articles section of your Readwise Dashboard.
### Web Clippers
You can use one of many "web clipper" apps such as [Hypothes.is](https://hypothes.is/) or [Worldbrain](https://getmemex.com/). These apps install an extension in your browser, enabling you to highlight things as you go. If you wish to use a web clipper, we recommend Hypothes.is because Readwise can directly integrate with the service and sync with no effort on your part. If you use Liner, you will need to periodically export your highlights to a CSV and then email those to [add@readwise.io](mailto:add@readwise.io).
## Import Highlights from BookFusion
[BookFusion](https://www.bookfusion.com/) makes it easy to highlight EPUBs and PDFs. Once you've made some highlights and annotations in their iOS, Android, or web app, you can quickly sync them to Readwise!
**Here are the steps to send your BookFusion highlights to Readwise:**
1. Login to your BookFusion account on a desktop computer. Exports can currently only be done via BookFusion's web app. However, any highlights and notes you made in the iOS or Android BookFusion app will also appear in your web app and can be imported to Readwise.
2. Open the ebook with the highlights that you want to sync and click the “Highlights & Annotations” icon (highlighted in blue):
3. Click the export icon in the right-hand corner and select Readwise.
4. Copy and paste your access token from: [https://readwise.io/access\_token](https://readwise.io/access\_token)
5. Click export and enjoy.
This is not an automatic or continuous import. You must click the export button each time to import new or updated highlights.
## Import Highlights from the Command Mobile Browser
Command is a highlighting-first web browser on iOS that makes it easy to save highlights from a webpage as you’re browsing.
Command has integrated Readwise into their app, enabling you to save highlights from webpages directly (and automatically) into Readwise!
To set it up:
1. Download the [Command Browser from the App Store](https://apps.apple.com/us/app/command-a-better-browser/id1485289520)
2. Tap the Command icon on the bottom toolbar and go to highlights
3. Tap the sync icon in the top left corner & tap add account
4. Tap Readwise & Login – your highlights will start syncing
Now – whenever you highlight in Command, your highlight & notes will sync automatically to Readwise and look something like this:
## Add Highlights from Audible
Audible doesn't make it possible to extract bookmarks or clips through the cloud, so there's currently no way for us to make use of this data. We're keeping a close eye on things, however!
In the meantime, you can add your Audible books into the Supplemental Books section to get the most popular highlights here --> [https://readwise.io/quick](https://readwise.io/quick)
Alternatively, some of our users use the following method to export their Audible highlights into Readwise:
### WhisperSync for Voice
[Audible](https://www.audible.com/) is owned by Amazon, so books with [WhisperSync for Voice](https://www.amazon.com/Whispersync-for-Voice/b?ie=UTF8\&node=12527156011) enabled will sync your reading location between the Audible and Kindle versions of your book. This makes it easy to make a highlight in your Kindle version while listening to the Audible version.
When you hear something you'd like to highlight, just pause Audible and open the Kindle app on your device. The Kindle app will automatically sync to the location of your Audible book.
Then, simply highlight the section you want in the Kindle app and return to listening in Audible.
## Import Highlights from Upnext
We used to support imports from Upnext, but as of March 1, 2024, [Upnext has shut down](https://www.getupnext.com/sunset). If you're looking for another read-it-later app that integrates seamlessly with Readwise, check out [Readwise Reader](https://readwise.io/read)!
[Upnext](https://www.getupnext.com/) is an iOS app to supercharge your continuous learning. Upnext lets you save any type of content for later, work through it when it suits you, and stay up-to-date with content from your favorite experts!
Here's how to automatically sync your Upnext highlights and notes to Readwise:
1. Select the library icon on the bottom navigation bar.
2. Tap the Account icon in the upper right-hand corner.
3. Under Integrations select Connect to Readwise.
4. Login to Readwise.
5. Select Readwise Access Token > Copy token > Input in Upnext field > Submit Access Token
## Import Highlights from Liner
The export feature of Liner described below is currently broken. You can email Liner support at [brian@getliner.com](mailto:brian@getliner.com) or Tweet [@getliner](https://twitter.com/getliner).
Liner doesn't offer a public API, so there's no way to build an automatic integration with their service. That said, there is a manual method to import your Liner highlights into Readwise. Here are the steps:
1. In Liner, select the articles to export highlights from by clicking the check mark circle in the upper right corner of each article.
2. Select Export in the right-panel and choose Email as shown below:
3. Send the export to add@readwise.io.
The highlights will be automatically imported into your Readwise account.
Note that you can alternatively highlight and right-click on any webpage in Chrome to quickly clip specific passages to Readwise as shown below:
## Import Highlights from Momento
We used to support Momento, but the app has been removed from the App Store. If you're looking for another podcast app that integrates with Readwise, check out Snipd: [How do I import highlights from Snipd?](/readwise/docs/importing-highlights/snipd)
[Momento](https://momento.fm/) is a great podcast app that enables effortless audio “highlighting” of any podcast on iOS and Android devices. Here's how to automatically sync your Momento highlights to Readwise:
1. Select **Settings icon** in the upper right-hand corner of Momento app
2. **Connect to Readwise**
3. **Get Access Token** > Copy token > Input in **Step 2** of Momento app > **Connect Readwise**
Import from PDF Files
## Can I import highlights from PDFs?
Please note that **support for PDF highlights is in perpetual beta** so you may discover a new bug from time to time. If you do, let us know and we'll do our best to fix it promptly!
To import highlights from a PDF, simply email the highlighted PDF file as an attachment to **add@readwise.io** (from an email address associated with your Readwise account).
That's it.
You can also upload PDFs by selecting the [PDF Import](https://readwise.io/import/pdf) option from Add Highlights.
## What PDFs work best?
PDF is a fickle file format, so some PDFs highlight better than others:
* **Digital PDFs.** Highlights extract much cleaner from digital PDFs than scanned PDFs with OCR applied.
* **Single Column PDFs.** Text in a single column extracts _much_ more accurately than two or three column PDFs. You can still extract highlights from multi-column PDFs: just be prepared for things to sometimes fall out of order. The absolute worst are PDF presentations with text all over the page.
* **Left-to-Right PDFs.**
## What happens if a highlight spans two pages?
Due to limitations of the PDF file format, the highlight will be broken into two separate highlights. Fortunately, we have a workaround. Use the concatenation feature described here: [How to Combine Highlights On-the-Fly with Readwise](https://blog.readwise.io/combine-highlights-on-the-fly/).
## What PDF reader apps work with Readwise?
Thus far, we've had positive results with the following apps (provided you are working with a clean PDF to begin with):
* Preview (on Mac)
* Adobe Acrobat
* PDF Expert
* LiquidText (note: there is a LiquidText glitch where you must do all of your highlighting in a single session)
* Foxit
* iAnnotate
* DEVONthink
* PDFPenPro
If you could let us know what PDF app you're using when you email **add@readwise.io** PDFs, it would really help us!
## Which PDF reader apps do not work with Readwise?
Believe it or not, there are some PDF reading apps that do not take normal highlights per the PDF annotation spec, so our parser cannot extract them. These apps include:
* MarginNote
* GoodNotes
* Notability
* Adobe Acrobat on iPad and Android tablets (we're looking into this)
If extracting highlights from PDFs is important to you, we recommend switching to one of the reader apps listed in the section above!
## Can I send multiple PDFs in a single email?
Yes, but the size of the attachments must be below 30 megabytes in total.
## How do title and author work?
Readwise extracts the document title and author name from the PDF metadata. Not every PDF reader application enables editing of these properties. If your preferred app does allow metadata editing, we encourage you to make it a habit to clean these up, as some PDFs have strange metadata for reasons unknown to us.
If the PDF has no metadata, Readwise will use filename as book title and leave the author blank.
If a PDF does import with incorrect metadata, you can edit the title and author in Readwise.
## I've imported PDF highlights but I can't find them in Readwise?
If you didn't receive an error email from Readwise, you likely can't find the PDF highlights in Readwise because the file had strange metadata. In other words, it's named something non-obvious. Open the PDF, find a highlight, and search Readwise for a fragment of the highlight text.
## Why does my PDF keep coming back with an error?
As a bit of background, PDF is an incredibly fickle file format originally created in 1993 for the purpose of printing digital documents to analog paper. Technology has come such a long way in the past 30 years that, if we had our druthers, we'd move people off PDF entirely and into something meant for the digital-first world (e.g. an ebook standard such as EPUB or MOBI).
Of course, network effects are strong and that's not going to happen for a long time, if ever.
Until then, we're gradually discovering edge cases and improving our parsing through a lot of manual hard-coding. In nearly all cases, we don't deliberately choose not to support a particular PDF reader. Instead, the PDF reader decides—for whatever reason—not to use the official PDF annotation spec but rather to, for example, draw yellow rectangles with transparency on top of the document. Other times, the PDF may look like ordinary text to the user, but It's really either a scanned image or series of tiny letter-shaped images (encoded entirely differently from text) which can't be picked up by ordinary software.
Import Highlights from Pocket
We used to support imports from Pocket, but as of July 8, 2025, [Pocket has shut down](https://support.mozilla.org/en-US/kb/future-of-pocket). If you're looking for another read-it-later app that integrates seamlessly with Readwise, check out [Readwise Reader](https://readwise.io/read)!
To import your Pocket highlights into Readwise, go to the [import integrations page](https://readwise.io/welcome/sync/) and click the Pocket option.
This will open a page where you can log in to your Pocket accout and grant it permission to share your data with Readwise.
Import from Raindrop.io
You can import your [Raindrop.io](https://raindrop.io/) highlights to Readwise with our native integration.
## Getting Started
1. Head to the Readwise import page and select the [Raindrop option](https://readwise.io/welcome/sync#raindrop).Ò
2. Connect to Raindrop.
3. Watch your Raindrop highlights automatically sync to reader, including tags and annotations:
As of right now, this integration only imports text-based highlights, not images.
## Re-syncing Highlights
Your Raindrop highlights should sync periodically throughout the day. If you ever want to instantly re-sync to import new highlights, head to the [import page](https://readwise.io/welcome/sync), locate Raindrop, and click "Sync Now."
The Raindrop.io import feature is still in beta! If you have any feedback or find any bugs, please reach out to us as [hello@readwise.io](mailto:hello@readwise.io) :)
Import from Refind
[Refind](https://refind.com/) is a discovery platform that delivers the essence of the web every morning in your inbox every morning. Thousands of busy people start their day with their personalized digest by Refind and save highlights and notes to remember the most important bits.
This integration is only available for Refind Premium subscribers.
Here's how to automatically sync your Refind highlights to Readwise:
1. On your desktop, click into your profile icon in the upper right and select Settings
2. Under Data, select Export > Readwise
3. Click the link to retrieve your Readwise Access Token, copy the token, and input it into the Refind field
4. Click Connect
Import from Snipd
[Snipd](https://www.snipd.com/) is a cutting edge podcast app (available on iOS and Android) that uses AI to automatically generate intelligent highlights and “chapters” of any English podcast. Here's how to automatically sync your Snipd highlights to Readwise:
1. Install the Snipd app on your [iOS](https://apps.apple.com/us/app/snipd-your-podcast-knowledge/id1557206126) or [Android](https://play.google.com/store/apps/details?id=ai.topicfinder.podcastdiscovery) device
2. Select Your Account in the bottom right of the app
3. Select Readwise Integration
4. Toggle on Enable Integration
5. Select [Find your Readwise Access Token here](https://readwise.io/access_token), copy the token, and paste it into the Snipd field
6. Tap Sync Existing Snips Now
Import from Twitter/X
## How do I save Tweets from Twitter to Readwise?
You can start saving Tweets and Twitter threads to Readwise by connecting your Twitter account to Readwise from the [dashboard](https://readwise.io/dashboard) > [Import](https://readwise.io/welcome/sync) > [Twitter](https://readwise.io/twitter\_start).
Once connected, you can save an individual tweet by replying with **@readwise save** as shown below:
Or you can send Tweets to **@readwise** via DM. If you DM the Tweet, any text you include in the message will be treated as a note in Readwise. (Great for [inline tagging](/readwise/guides/action-tags#inline-tagging)!)
You can save entire Twitter threads by replying with **@readwise save thread** as shown below:
You can also DM the thread to **@readwise** with the word **thread** or **t** in the message. Any text you include in the message will be treated as a note in Readwise.
If your Twitter account is set to private, please message us at [hello@readwise.io](mailto:hello@readwise.io) to follow you on Twitter so that we can see the tweets/threads you save and import them into your library for you.
You can still tag "[@readwiseio](https://twitter.com/Readwiseio) save" in your Tweets if you want, or you can use [@readwise](https://twitter.com/readwise) and save yourself 2 characters—both work :)
## Can I save Tweets to Readwise by bookmarking them?
Yes! You can find the settings for the sync from the [dashboard](https://readwise.io/dashboard) > [Import](https://readwise.io/welcome/sync) > [Twitter](https://readwise.io/twitter\_start). Once you authorize the connection, you can choose to automatically sync new bookmarks once a day.
This feature is experimental and relies on the stability of Twitter's API. If you encounter any issues, please let us know at [hello@readwise.io](mailto:hello@readwise.io) so we can continue building a better integration.
## How do I prevent Twitter thread duplicates in Readwise and Reader?
By default, individual Twitter posts will be saved as a highlight to your Readwise account, while Twitter threads will be saved to Reader as an article.
If your threads or single tweets are appearing in both places, it’s possible that your Twitter settings are causing an overlap.
To adjust this, click into your [Preferences](https://read.readwise.io/preferences) in Reader and select [Integrations](https://read.readwise.io/integrations). Click the Settings button to expand the options (see screenshot below). To reduce duplicates, make sure that each type is only checked on for either Reader or Readwise, rather than both.
## Why does Readwise need both read and write Twitter permissions?
Protecting the privacy of our users is important to us, but unfortunately Twitter's current API provides only three permission levels for developers:
Source: [https://twitter.com/settings/applications](https://twitter.com/settings/applications)
At this time, this is the only way to enable our users to share Tweets to their own timelines as well as save Tweets to their Readwise accounts.
However, as an important note: we will **never** tweet anything without your permission, and we do not read any data but your tweets to @readwise.
## Can I connect a second Twitter account to Readwise?
You can connect multiple Twitter accounts to Readwise from the [Twitter integration settings page](https://readwise.io/twitter_start). On the left side of the page, you'll see a list of currently connected Twitter accounts. To connect a new one, click **Add another account**.
This will open the Twitter authorization page and allow you to grant Readwise permission to access your account. Note that you'll want to be logged into the target account (or logged out entirely) before clicking this, since it will prompt the authorization for whichever account is currently logged in.
To remove a connected account, click the gray **X** to the right of the account name.
Import from Voicenotes
[Voicenotes](https://voicenotes.com/) is a speech-to-text transcription app with built-in AI features, allowing you to take audio notes and then easily generate summaries, key takeaways, to-do lists, and much more.
The Voicenotes to Readwise integration automatically imports your notes as Readwise highlights as soon as you create them.
## How do I import my Voicenotes to Readwise?
1. Log in to your [Voicenotes account](https://voicenotes.com/app/), then click into the account settings in the top right
2. Click into **Integrations**, then select **Readwise**.
3. Paste your [Readwise API token](https://readwise.io/access_token) into the first field of the settings and configure the other options to suit your preferences. Click **Connect**.
Once you've conencted your accounts, any new notes you create in Voicenotes will be exported to Readwise and will appear under the category you selected during setup (Articles, Books, Tweets, or Podcasts).
Webhooks
# Webhooks
Webhooks allow you to receive real-time notifications when certain events occur in your Readwise account. This enables you to integrate Readwise with external services and automate workflows based on your reading activity.
## Overview
Readwise supports two types of webhook integrations:
1. **Zapier Webhooks** - Automatically managed through Zapier's platform
2. **Custom Webhooks** - Manually configured endpoints for direct integrations
## Zapier Webhooks
Zapier webhooks are automatically created and managed when you set up a Zap that uses Readwise as a trigger. These webhooks are handled entirely through Zapier's interface and don't require manual configuration.
### Features
- **Automatic Management**: Created and deleted automatically by Zapier
- **Built-in Authentication**: Uses Zapier's OAuth flow
- **No Manual Setup**: Configuration happens through Zapier's interface
- **Reliable Delivery**: Benefits from Zapier's retry mechanisms
### Setting Up Zapier Integration
1. Go to [Zapier](https://zapier.com) and create a new Zap
2. Choose Readwise as your trigger app
3. Select the event you want to trigger on
4. Follow Zapier's authentication flow to connect your Readwise account
5. Configure your action app and complete the Zap setup
## Custom Webhooks
Custom webhooks allow you to send notifications directly to your own endpoints, giving you full control over how you handle Readwise events.
### Features
- **Direct Integration**: Send events directly to your endpoints
- **Custom Processing**: Handle events exactly how you need
- **Webhook Signatures**: Secure your endpoints with secret verification
- **Multiple Event Types**: Subscribe to specific events that matter to you
### Setting Up Custom Webhooks
1. Navigate to [Readwise Webhooks page](https://readwise.io/webhook)
2. Click "Create New Webhook"
3. Fill in the required information:
- **Name**: A descriptive name for your webhook
- **URL**: The endpoint where you want to receive notifications
- **Event Types**: Select which events you want to subscribe to
- **Description** (optional): Additional notes about this webhook
### Webhook Security
Each custom webhook includes a secret key for verifying the authenticity of requests:
- **Secret Generation**: Automatically generated 32-character secret (sent in POST request data)
- **Signature Verification**: Use the secret to verify webhook payloads
- **HTTPS Recommended**: Always use HTTPS endpoints for security
### Testing Webhooks
Before creating a webhook, you must test your endpoint:
1. Enter your webhook URL
2. Click "Test Endpoint"
3. Ensure your endpoint returns a successful response
4. Only after successful testing can you create the webhook
## Available Event Types
Readwise supports the following webhook event types:
### Readwise Events
#### `readwise.highlight.created`
Triggered when a new highlight is created in your Readwise library.
### Reader Events
#### `reader.any_document.created`
Triggered when any new document is added to Reader (articles, PDFs, etc.).
#### `reader.feed_document.created`
Triggered when a new document is added from an RSS feed or newsletter subscription.
#### `reader.non_feed_document.created`
Triggered when a new document is manually added (not from feeds).
#### `reader.document.tags_updated`
Triggered when tags are added, removed, or modified on a document.
#### `reader.document.finished`
Triggered when a document is marked as finished/read.
#### `reader.document.archived`
Triggered when a document is archived.
#### `reader.document.moved_to_later`
Triggered when a document is moved to the "Later" queue.
#### `reader.document.moved_to_inbox`
Triggered when a document is moved back to the inbox.
#### `reader.document.shortlisted`
Triggered when a document is added to your shortlist/favorites.
## Webhook Payload Format
All webhooks send JSON payloads with the structure differring based on the entity we are sending.
### Document
```json
{
"id": "01kb5cap1wy21zp37bc2rjj",
"url": "https://read.readwise.io/read/01kb5cap1wy21zp37bc2rjj",
"title": "Our Black Friday sale ends soon! Subscribe now",
"author": "The Verge",
"source": null,
"category": "email",
"location": "feed",
"tags": {
"media": {
"name": "Media",
"type": "generated",
"created": 1764338530643
},
},
"site_name": "The Verge",
"word_count": 174,
"reading_time": "1 min",
"created_at": "2025-11-28T14:02:02.213618+00:00",
"updated_at": "2025-11-28T14:02:10.648147+00:00",
"published_date": "2025-11-28",
"summary": "The Verge is offering a limited-time Black Friday discount on its subscription. For $4 a month or 40% off a yearly plan, you get ad-free podcasts, premium newsletters, and exclusive Q&As. The deal ends soon, so act fast.",
"image_url": null,
"content": null,
"source_url": "mailto:reader-forwarded-email/90049694f7dbf92219bf18a1f6a",
"notes": "",
"parent_id": null,
"reading_progress": 0,
"first_opened_at": null,
"last_opened_at": null,
"saved_at": "2025-11-28T14:02:02.173000+00:00",
"last_moved_at": "2025-11-28T14:02:02.173000+00:00",
"event_type": "reader.any_document.created",
"secret": "lphrx901Iq3kzswFSth5ST"
}
```
### Highlight
```json
{
"id": 954480,
"text": "Most Amazing Highlight Ever",
"note": "",
"location": null,
"location_type": "page",
"highlighted_at": "2025-11-27T18:55:56.719036Z",
"url": null,
"color": "",
"updated": "2025-11-27T18:55:56.867572Z",
"book_id": 8237,
"tags": [],
"event_type": "readwise.highlight.created",
"secret": "8mFG0SsX8Xe199sRG2A3"
}
```
How to Use Action Tags
Action tags are highlight notes that use a specific syntax to perform actions on the associated highlight. All action tags begin with a `.` character, and they effect how the highlights appear in Readwise.
## Concatenation
Have you ever found yourself highlighting an entire fluff-filled paragraph even though all you really wanted were the key sentences at the beginning and end?
To overcome this problem, you can use the *conconatenate action tag*: a special note taken while you read that combines multiple, non-adjacent highlights into a single annotation in Readwise. Your concatenated highlights will be both shorter and clearer, streamlining your future reviews.
Highlight the first string of text you want to combine and add the note `.c1` ("c" for "concatenate"). Then highlight the second string of text and add the note `.c2`. Upon importing into Readwise, these two highlights will be combined into a single annotation.
You can string as many highlights together in this way as you’d like by continuing on to `.c3`, `.c4`, etc. A tag of `.c1` will always begin a new concatenation string.
The concatenate action tag works across *all* e-reading platforms supported by Readwise, including [Amazon Kindle](/readwise/docs/importing-highlights/kindle), [Apple Books](/readwise/docs/importing-highlights/apple-books), and our own read-it-later app [Reader](/reader/docs/faqs/action-tags#how-can-i-create-headings-between-my-highlights).
## Inline Tagging
Readwise has some very powerful features, such as [Themed Reviews](/readwise/guides/themed-reviews), that are most useful when they can pull from a pool of tagged highlights. However, setting aside time to go through your recent highlights and tag them appropriately can be cumbersome, and waiting for them to appear in your Daily Review delays the utility of the tag.
This is where *inline tags* come into play.
Inline tags allow you to add a highlight note wherever you may be reading (Kindle, Kobo, etc.) that will be automatically converted to a tag when the highlight is synced to Readwise. To create an inline tag, start any note with a `.` and follow it with a single word or abbreviated (no spaces).
For example, let's say you're interested in the subject of probability and you come across a thought-provoking passage describing the difficulty of defining what probability actually means. You want to save this passage for later, so you highlight it. You also want to attach the keyword "probability" so when you see this passage again, you know immediately what it's about. To use inline tagging, simply add the note `.probability` in addition to the highlight.
That's it! Your highlight is now tagged.
## Headings
The heading action tag is a special note taken while you read that captures a book's structure—its parts, chapters, sections, and subsections. Once you've captured this data, the more intuitive location context of chapters becomes available in Readwise.
Even though your highlights from books typically include a page or "location" number, this context is largely meaningless unless you happen to be writing a paper requiring proper citations. For most of us, it'd be far more useful to see location in terms of the highlight's part, chapter, section, or subsection. The heading action tag makes this possible.
To create a heading, simply highlight the title of each section and add a note beginning with a period (`.`) followed by an `h` (for "heading") and then the number `1` through `3`, representing the section's position in the hierarchy.
For example, with a book organized into parts, chapters, and sections, you would denote all parts as `.h1`, all chapters as `.h2`, and all sections as `.h3`.
You can start with lower level headings (e.g. `.h3`) and they’ll still appear in Readwise, but for the table of contents to appear on the left side of the page, you’ll need to start with at least one `.h1` tag.
Chat With Your Readwise Highlights
At its core, this feature is essentially a super-powered search across every highlight you've ever made. Use plain language to find specific highlights, even if you might not remember when you took it, who the author was, or even exactly what it was about.
## How can I start chatting with my highlights?
To get started, click the [Chat](https://readwise.io/chat/) button at the top of your Readwise dashboard.
On mobile, you can access the Chat feature from the home screen by tapping **Chat With Your Highlights**.
If you've ever used another AI tool—like ChatGPT or Perplexity—the Chat interface should feel quite familiar.
Here's a quick overview of the options you'll see:
1. **Ask a question:** Type your question or search into the text box. Use the `enter` key or the arrow icon to submit your query.
2. **Suggestions:** Ideas for things you could ask your highlights. Clicking one of these will create a new chat.
3. **Toggle sidebar:** Open the sidebar to see your previous chats.
## Can I see which highlights were used to generate the answer?
Of course! Below the Chat's response, you'll see a section called **Relevant Highlights** ➊. Clicking any of the highlight cards or the **See more** button will open a side panel where you can see the full text of the highlights.
This section is separated into two sections: **Referenced Highlights** ➋ and **Other Relevant Highlights** ➌. "Referenced highlights" are the ones that were used to generate the answer. "Other relevant highlights" are ones that were used to generate the answer, or might be relevant to the question, but weren't referenced directly.
## What can I ask my highlights?
You can ask anything! The response will likely be better if you ask about things related to your highlights, but experimentation is the heart of discovery so feel free to get creative.
That said, there are a few places where we think the Chat With Highlights feature excels. If you're not sure where to start, here are some ideas.
### Semantic Search
Trying to find a highlight but can’t remember the precise words or where you read it? Describe the rough idea and Chat will find the exact highlight.
**Examples**
- I’m trying to find a Paul Graham quote about rejecting social media.
- In Tiny Beautiful Things there’s a line about the truth that lives there. Can you pull up that quote and its larger context?
### Synthesize Ideas
Ask a question and Chat will synthesize an answer based on your entire reading history.
**Examples**
- As a product manager, how should I balance building features for power users, and features for broader, adjacent markets?
- What are some common mistakes new writers make when writing non-fiction stories?
- How can I find my purpose in life?
### Quiz Me
You can ask Chat to create questions to test your knowledge, based on previous highlights.
**Examples**
- Please generate a series of multiple choice questions quizzing me on the most common drumming rudiments.
- I'm studying for the Korean TOPIK exam. Can you ask me some open-ended questions about Korean verb conjugation to quiz me?
## Can I find highlights based on what platform I took them on?
Yes! You can ask a question like "what tweet did I save about the best way to learn a new language?" or "what was the highlight about oranges I took last week on my Kindle?"
The ability to search by platform is just one of the ways that this feature is more robust than a traditional text search.
## What AI model powers Chat With Highlights? Can I change it?
By default, Chat With Highlights is powered by OpenAI's OpenAI's `GPT-5` model with fairly low thinking. However, if you'd prefer to trade speed for intelligence, you can switch to a more thoughtful version of the model via the dropdown menu in the left corner of the chat box.
## Can I chat with my highlights using a different client/model?
You can! If you'd like to communicate with your highlights using an external chat client instead of Readwise's built-in chat interface, you can set up your own MCP (Model Context Protocol) server. It might sound like a complicated, tech-heavy concept, but you can actually [configure it without too many steps](/readwise/guides/mcp).
How to Increase Retention with Mastery
The Mastery feature converts your Readwise highlights into active recall formats such as Q&A and cloze deletion. By actively engaging with the material, you reinforce understanding and improve retention. This method transforms passive reading into an active learning adventure, making your knowledge more durable and actionable.
## Creating a New Mastery Card
If you encounter a highlight in your Daily Review that contains information you want to remember better, simply click or tap the **Master** button below the card. If you're on a computer, you can use the keyboard shortcut `M`.
This will open up the Mastery card editor for the chosen highlight.
To create a Mastery card from a highlight outside of your Daily Review, navigate to the document within your [Readwise library](https://readwise.io/everything). After opening the document, find the highlight you'd like to convert, click the card to open the highlight view, then click the Mastery icon from there.
## Q&A Cards
Q&A cards use the traditional concept of a flashcard: question on the front, answer on the back.
To create a Q&A Mastery card, click the **Question & Answer** tab at the top of the Mastery editor.
Come up with an insightful question about the highlighted passage and type it into the **Question** field. If the passage easily answers the question, you can click **Use highlight text as answer**, or you can write your own answer in the **Answer** field.
Click **Save** to view your new flashcard.
Try using [the .qa Action Tag](/readwise/guides/action-tags) with a [custom Ghostreader prompt](/reader/guides/ghostreader/custom-prompts) in Reader to easily create Readwise flashcards as you read.
## Cloze Deletion
With cloze deletion, a salient keyword or keyphrase is hidden from the passage, giving you an opportunity to pause and consider the missing word.
To create a cloze deletion Mastery card, click the **Cloze Deletion** tab at the top of the Mastery editor. (This is the default tab when opening the editor.)
Find the word or phrase you want to hide and select it.
Once you've selected the appropriate text, click **Save** to view the new flashcard.
## Reviewing Mastery Cards
Once you've created your first Mastery card, your Daily Review will be divided into two halves. The first half will contain unprocessed highlights which have never been reviewed before in Readwise or haven't been converted to Mastery cards. The second half of your Daily Review will contain your Mastery cards. These are resurfaced according to a [spaced repetition algorithm](/readwise/docs/faqs/reviewing-highlights#how-does-the-readwise-spaced-repetition-algorithm-work-mastery) and presented in active recall form.
Each time you review a Mastery card, you'll be prompted to give feedback on how quickly you'd like to review it again: soon, later, or someday. (You can also select "never" if you'd like to remove the card entirely.)
If you had no idea what the answer was, you might want to choose "soon", but if you knew it immediately and don't feel you'll be forgetting it immediately, you could choose "someday" instead.
## Retention vs Memorization
The first time most people see Mastery in Readwise, they tend to assume it's about memorization. Sometimes they even assume it's about *rote* memorization.
While that assumption is understandable, we want to emphasize that Mastery is *not* about memorization. The point isn't to memorize a text verbatim so you can pedantically rattle off some passage word-for-word at a cocktail party. (Even though that can be a very fun party trick, in the right crowd.)
No, the point is to reprogram your brain. To prime your mind to spot patterns, form connections, and resurface the right idea at the right time. For example, if you apply Mastery to *Deep Work* and your weekly calendar starts to fill with shallow calls and meetings, your mind will likely notice the pattern and then start nudging you to create some uninterrupted space. *Maybe I should schedule a four-hour focus block to protect that currently unoccupied Thursday morning?*
Many Readwise users are frustrated by the inefficiency of books because they spend lots of time reading but then forget so much, leading to little or no change in their daily lives. If that resonates with you, Mastery could be the key you need to unlock the full power of your book smarts.
How to use the Readwise MCP
## What is the Readwise MCP?
The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) standardizes how applications provide context to Large Language Models (LLMs). The Readwise MCP was created to act as a bridge between LLM clients and Readwise.
In simpler terms, setting up your own Readwise MCP server allows you to chat with your Readwise highlights using an external chat client (such as Claude), rather than the [Chat function](/readwise/guides/chat-with-highlights) on the Readwise website.
## Use the Readwise MCP with Claude Desktop
The following instructions will help you configure the [Readwise MCP](https://www.npmjs.com/package/@readwise/readwise-mcp) to work inside of your Claude Desktop app.
Before beginning the MCP setup, [make sure you have Node installed](#how-do-i-install-node). The Readwise MCP relies on Node to perform the connection, so it won't work if Node is missing.
1. Open the Claude Desktop app. If you don't have the desktop version install yet, you can [download it here](https://claude.ai/download).
2. In the sidebar of the app, navigate to **File > Settings > Developer** (`cmd + ,` on Mac).
3. Click **Edit Config**. This will take you to the configuration file's location in your file browser.
4. Open the config file in your text editor of choice. ([Visual Studio Code](https://code.visualstudio.com/) is a great free option if you don't have one already!)
5. Add the following entry to your `claude_desktop_config.json` file.
**IMPORTANT:** Replace the `ACCESS_TOKEN` value with your [Readwise Access Token](https://readwise.io/access_token)!
```
{
"mcpServers": {
"Readwise MCP": {
"command": "npx",
"args": [
"-y",
"@readwise/readwise-mcp"
],
"env": {
"ACCESS_TOKEN": "XXXXXXXXX"
}
}
}
}
```
6. Start chatting with your highlights in Claude!
### FAQs and troubleshooting
#### I'm getting an error when I add the `mcpServers` entry to my config file. What do I do?
If your `claude_desktop_config.json` file is empty when you open it, you can simply copy/paste the code provided in the instructions above.
However, if your file already has any content, you'll need to make sure you only add the actual `mcpServers` entry, without the exterior curly brackets. The screenshot below shows an example of how the new entry should be added in a file that already has an updated setting for Claude's global activation hotkey.
Note the comma added after the existing `globalShortcut: "Ctrl+Space"` code!
#### How can I tell that the MCP server is set up?
Once you've set up your MCP config, the New Chat screen of Claude will display a couple of new icons.
The first icon indicates the number of MCP tools you've set up to work with Claude. If Readwise is your first, it should say 1. The second icon indicates that an MCP server is connected and able to share context with Claude.
Clicking either icon will open a modal and display information about the Readwise connection.
#### How do I install Node?
If you do any programming in your daily life, either for work or as a hobby, there's a good chance you already have Node installed on your computer. But if you've never needed it before (and most people likely haven't!), you can [download it from the NodeJS website](https://nodejs.org/en/download).
The simplest installation option is usually the installer, which you can download by selecting your operating system (➊) and then clicking the green button (➋).
You shouldn't need to do anything other than install it. The Readwise MCP configuration just needs to be able to find it on your system!
#### Why did I get an error while chatting?
When using this server, you may occasionally encounter MCP errors during your conversations with Claude. If you experience an error, we recommend switching between different Claude models (e.g. from Claude 3.5 Haiku to Claude 3.7 Sonnet), which will often resolve the issue.
## Use the Readwise MCP with Raycast
[Raycast](https://raycast.com) is a supercharged launcher and productivity tool for MacOS. Among its *many* other capabilites, Raycast now has the ability to hook into MCP servers while using its AI Chat feature.
To get started with the Readwise MCP in Raycast, search for the `Install Server` command of the Raycast MCP extension.
Fill out the install form with the following information:
- **Icon:** Select an icon from the Raycast options. (The "Blockquote" option is decently apt!)
- **Name:** This can be whatever you'd like to use to reference the server in your AI chats. We recommend "Readwise" or "Readwise MCP" to keep things simple.
- **Command:** `npx`
- **Arguments:** `-y @readwise/readwise-mcp`
- **Environment:** This is a two part field. Click "Add Item" to reveal the subfields.
- **Key:** `ACCESS_TOKEN`
- **Value:** Your [Readwise Access Token](https://readwise.io/access_token).
- **Description:** *(optional)* You can probably leave this blank if you're just using the server for your own purposes, or you can enter something like "Search your Readwise highlights."
Once you configure the server, you can use it in the Raycast AI Chat (quickly accessible by opening Raycast and pressing `tab`) by typing `@` and whatever you used in the **Name** field (e.g. `@readwise-mcp`).
Note that it might ask you to confirm that you want to run the command before it actually executes. You can quickly authorize it with `cmd + enter` to continue with the chat.
If you want to learn more about how MCP servers work with Raycast, check out [the MCP page of the Raycast Manual](https://manual.raycast.com/model-context-protocol).
## Use the Readwise MCP with ChatGPT
At this time, only ChatGPT users with **Pro, Team, or Enterprise plans** have access to the MCP functionality of ChatGPT. This feature is not currently available for users with free or Plus accounts.
To get started with the Readwise MCP in ChatGPT, go to [chatgpt.com](https://chatgpt.com/) and log in to your account. Open **Settings** from the bottom left corner of the screen.
Go to the **Connectors** option in the Settings menu sidebar, then click the **Create** button.
Fill out the form with the following information:
- **Logo:** *(optional)* Upload an image to represent the connection. We've made one with the Readwise logo that you can download here, to make the connection look properly official.
Download Readwise icon
- **Name:** This can be whatever you'd like to use to find the connection in the list. We recommend "Readwise" or "Readwise MCP" to keep things simple.
- **Description:** *(optional)* You can leave this blank, or you can enter something like "Search your Readwise highlights."
- **MCP Server URL:** `https://mcp.readwise.io/sse`
- **Authentication:** Use the `OAuth` option.
- **I trust this application:** Check this box. (We promise we won't steal your data!)
Once you click **Create**, you'll be briefly redirected to the Readwise website to authenticate the connection. Click **Authorize** to continue.
After authorizing, you may initially see an error about `search action not found`. If you do, click the **Refresh** button and the error message should disappear.
Back in the chat interfact, turn on the **Connected apps** option in the `+` menu, then select Readwise from your Sources list.
Once you've selected Readwise as a Source, you can chat with your Readwise highlights directly in ChatGPT.
How to Create a Themed Review
A Themed Review is a collection of highlights that—as the name implies—follows a theme. This is separate from your Daily Review, and it can be set up to gather highlights manually from specific sources or to gather them automatically based on a theme you describe.
You can access the feature by scrolling to the bottom of your Dashboard and selecting [Themed Reviews](https://readwise.io/themed\_reviews). If you haven't created any Themed Reviews yet, then you'll be automatically directed to [create a new Themed Review](https://readwise.io/themed_reviews/add).
If you have existing Themed Reviews, you can add a new one by clicking **+Add New Theme** at the top of the page.
Themed Reviews count toward your Readwise streak, so you won't need to do your Daily Review to keep your streak if you consistently do a Themed Review instead.
## Creating a new Themed Review
When creating a new Themed Review, you'll first be prompted to give it a name. You can also select a color, which will be used for the review card that appears on your Readwise dashboard.
Next, you can opt to select your highlight sources manually or to use the automatic selection feature.
### Automatic selection
Using the AI-powered automatic selection feature allows you to create dynamic and cohesive Themed Reviews without needing to have manually tagged all of your highlights or remember every book you've read that might be related. You can quickly describe your theme idea, and the automatic selection will resurface highlights related to that particular topic.
To use the automatic source selection, turn the "Auto Select Sources" toggle on.
You'll be offered a few suggestions for themes based on your highlights, and clicking one of them will automatically populate the theme for you and show a preview of the highlights that will be included.
To create your own theme, just type your idea into the **Theme** field. You can write a list of general theme words, like `writing, creativity, self-publishing`, or more of a descriptive sentence, like `highlights about finding yourself and making a difference in the world`.
You'll see a preview of your highlights that fit the theme you've described, so you can get a sense for what the Themed Review will include before you save it.
### Manual selection
To manually select your Themed Review's sources, turn the "Auto Select Sources" toggle off.
You can select any combination of books, articles, tweets, notes, and [tags](https://readwise.io/tags/) using the **Sources** field.
### Additional customizations
Once you've named your review and selected highlight sources, either automatically or manually, you have a couple more configuration options.
1. **Highlights Per Review:** This slider allows you to select how many highlights you'd like to see in each iteration of the Themed Review. The default is 5, but you can go as high as 15 or as low as a single highlight.
2. **Review Frequency:** This allows you to select how often you'd like this review to appear. By default, it's set to "Daily", but you can configure this however you'd like: only weekdays, only weekends, only Tuesdays and Saturdays, once a month, etc.
3. **Send Emails:** If this toggle is ON, you'll receive your Themed Review by email at your chosen frequency. If the toggle is OFF, you won't receive emails, but you'll still see the Themed Review appear at the top of your Readwise dashboard on any day that matches the frequency pattern.
4. **Add New Theme:** Click this button when you're done configuring and want to save the theme! (Or click "Cancel" if you've changed your mind and want to throw away all your work.)
## Use cases & ideas for automatic selection
Are you intrigued by the idea of AI-powered automatic selection for your Themed Reviews, but you're running low on inspiration? Here are some ideas and uses cases to get you started.
### Review highlights from a specific author
To create a Themed Review for a specific author with the original manual selection, you would need to individually select each document in your sources, then edit your Themed Review each time you read a new document written by them.
With automatic selection, you can say `highlights from James Clear` or `books by Brandon Sanderson` and those highlights will be collected for you. Even better, new documents will be automatically included into the Themed Review without you needing to make any updates.
### Resurface old, untagged highlights
Maybe you've recently decided you want to learn more about a particular topic, but you know you read some books or articles about the topic before you thought to start tagging your highlights. Using the automatic selection method allows you to resurface those highlights, and maybe even find some that you don't remember making!
For example: Romi on our CX team is a new mother and used the automatic selection to create a Themed Review about parenting. She was surprised to find that it included highlights she took over a decade ago, long before her daughter was even a twinkle in her eye ✨
### Make unexpected connections
One of the biggest benefits of using an LLM to power this feature is that it doesn't need to be literal or an exact match, so you can experiment will all kinds of vague concepts.
For example: Our technical writer Cayla decided to have a bit of fun and type in `life, the universe, and everything`. As would be expected of a more basic search, the preview did include her highlights from the Douglas Adams novel of the same name. However, it also included a variety of highlights about metaphysics, astronomy, and humanity's search for the meaning of life. Useful? Maybe not. But did it spark joy? It absolutely did.
## Themed Review FAQs
### Can I edit an existing Themed Review?
Of course! To edit any of your Themed Reviews, go to the [Manage Themes page](https://readwise.io/themed_reviews) and click the list item of the theme you'd like to change. You'll see all the same options as when you create a new theme, and you can make changes to any of them.
### Can I delete a Themed Review?
Yes! To delete a Themed Review, go to the [Manage Themes page](https://readwise.io/themed_reviews) and click the three dots (`...`) at the right side of the review you'd like to delete, then select **Delete**.
### How else can I use Themed Reviews?
The most obvious application of Themed Reviews is to create stacks of topically related highlights, such as “Spirituality” or "Programming.”
But the possibilities for Themed Reviews go far beyond subject-based reviews and mastery. You can use Themed Reviews to learn new skills and concepts, spark connections, think through hard problems, and even fuel a writing practice.
Because this feature is so flexible, we created a video explaining some of the many ways it can be used. (Note that this video was made before we added the automatic source selection option, so the interface will be slightly different.)