Tags on Links

New in v0.6 · Live demo

You can attach terms to any link using the data-octothorpes attribute. This lets you categorize bookmarks, citations, and other links the same way you'd tag a page.

Markup

Add data-octothorpes to any link that already has an octo: rel. The value is a comma-separated list of terms.

<a rel="octo:bookmarks" data-octothorpes="gadgets,bikes" href="https://example.com/review">
  Bike Gadget Review
</a>

<a rel="octo:cites" data-octothorpes="methodology,criticism" href="https://example.com/paper">
  Cited Paper
</a>

The terms are stored on the link relationship itself, not on your page. They're separate from your page-level hashtags.

In the API response

Tagged links appear in blobject results with a terms array alongside the link's uri and type:

{
  "@id": "https://yoursite.com/bookmarks",
  "octothorpes": [
    {
      "type": "bookmark",
      "uri": "https://example.com/review",
      "terms": ["gadgets", "bikes"]
    },
    {
      "type": "cite",
      "uri": "https://example.com/paper",
      "terms": ["methodology", "criticism"]
    }
  ]
}

Links without data-octothorpes will not have a terms field.

Works with any link type

data-octothorpes works on octo:bookmarks, octo:cites, and octo:octothorpes links.

<a rel="octo:octothorpes" data-octothorpes="tools" href="https://example.com/tools">Tools</a>