How to Import Highlights from Hypothesis into Glasp

Do you use Hypothesis to annotate articles and now want to transfer those highlights into Glasp? Many users have requested this feature, and Glasp now makes it easy to import Hypothesis highlights and notes directly into your Glasp profile.

This tutorial will guide you step by step on how to connect Hypothesis with Glasp, sync your annotations, and manage them for long-term learning and sharing.

If you haven't signed up for Glasp or installed the Glasp browser extension, please do so. You can refer to this tutorial.

How to Import Highlights from Hypothesis into Glasp (YouTube)

Step 1: Go to the Settings page

Click your profile icon at the top right.

It opens a modal, so please click the Settings section.

On the Settings page, you can see Integrations. So, please click it and go to the section.

In the Integrations section, you can find Hypothesis (Beta). Please find the API Keys and click it.

Step 2: Get Hypothesis's API key

In this step, you need to find and input Hypothesis's API key. You can see a text link, Hypothesis API key, so please click it. It opens Hypothesis's Developer page.

If you are asked to log in to Hypothesis, please do so.

On this page, you can find the API key. So, copy it. Please don't share the API key anywhere.

After you copied the API key, go back to the Glasp's Integrations page. Paste the API key and click the Save Key button.

Step 3: Import Hypothesis's highlights

Please choose the color you'd like to use for the imported highlights. You can choose from four colors.

After choosing the color, please click the Sync Now button. It starts importing highlights from Hypothesis into Glasp. Please notice that the imported highlights are publicly viewable to any users. So, if you don't want them to be visible, please delete the highlights before importing.

If you have successfully imported the highlights from Hypothesis, you can see "Successfully synced ~~ annotations!"

Step 4: View the imported highlights

To see the imported highlights, please go to My Highlights page. You can access it by clicking My Highlights at the top left.

On the My Highlights page, you can see the imported highlights. The order of highlights is chronological. The date of the imported highlights on Glasp is the same as the date you highlighted on Hypothesis.

You can add category tags, notes, an author, and a page comment to the imported articles.

(Optional) Step 5: Delete highlights

If you'd like to delete a highlight, please click the three dots next to the highlight, and click Delete Highlight.

If you'd like to delete the whole article, please click the three dots at the top right and click Delete Page.

This import function is not automated, so if you highlight with Hypothesis and would like to sync to Glasp, please click the Sync Now button on the Integrations page.

Note: Please notice that the imported highlights are shown on Glasp, but not on the original article. So, if you open the link and go to the article, you can see the highlights on the sidebar, but you cannot see them over the sentences.

Note: When you highlight an article with Glasp, and then try to import the same article's highlights from Hypothesis, the overlapped highlights are not imported into Glasp. It is to avoid duplication.

FAQs

Q. Do I need a Hypothesis account to import highlights into Glasp?

Yes. You’ll need to log in to your Hypothesis account and obtain your personal API key to connect with Glasp.

Q. Are imported Hypothesis highlights public or private on Glasp?

By default, imported highlights are publicly visible on your Glasp profile. If you prefer them to remain private, you should delete them after import or adjust visibility settings.

Q. Can I choose how my Hypothesis highlights appear in Glasp?

Yes. During import, you can select a highlight color (from four options). After import, you can also add tags, notes, authors, and page comments.

Q. Do imported highlights show up on the original article?

No. Imported highlights are visible in your Glasp profile sidebar but will not appear over the text of the original article itself.

Q. What happens if I already highlighted the same article in Glasp?

If you try to import highlights from Hypothesis for an article you’ve already highlighted in Glasp, duplicate highlights will be skipped automatically.

Q. Can I automatically sync Hypothesis highlights with Glasp?

Not yet. The import process is manual. Each time you want to sync new Hypothesis highlights, go to Settings → Integrations → Sync Now.

Q. Can I delete Hypothesis highlights after importing?

Yes. You can delete individual highlights or entire articles from your Glasp profile at any time.

Before you leave

If you have any questions, please refer to the FAQ or contact us.

👉 FAQs

👉 X

👉 Reddit

See you next time,

Glasp team