← All NIPs

NIP-B0

Web Bookmarks

DraftEvents

Save and share web bookmarks as kind 39701 events: the d tag is the bookmarked URL, and you can edit the title, tags and notes later.

Status
In use and still allowed to change.
Kinds
Tags
  • t
  • title
Last changed
Jul 31, 2026

Try it

Edit the form or the JSON: both stay in sync, the badge says whether the result is valid, and tapping any field explains it.

Examples
Valid 1 note

Not signed yet · Demo keys only. These personas' secret keys are public on purpose.

Form
Jan 1, 2025, 12:00 AM UTC

Content

Your description of the page. May be empty.

Tags

  1. d Required

    The bookmarked URI, which is also this event's identifier.

  2. published_at Optional

    When you first bookmarked it. Stays the same when you edit.

    Dec 30, 2024, 11:06 PM UTC
  3. title Optional

    The page title, usable as the text of a link.

  4. t Optional

    A topic or hashtag for the bookmark.

  5. t Optional

    A topic or hashtag for the bookmark.

Add tag

How this NIP works

Step 1 of 5

The URL is the address

Kind 39701 is addressable and its d tag is the bookmarked URL, so each person has at most one bookmark per URL and saving it again updates it.

In the course

No course chapter covers this NIP yet. The editor above is the quickest way in.

Builds on

See also

  • NIP-22 Comment

    Comments on bookmarks are NIP-22 comments.

  • NIP-51 Lists

    NIP-51 bookmark lists collect notes; NIP-B0 saves web pages, one event each.

Specification

Specification text is quoted in English from the nostr-protocol/nips repository. Our explanations and the interface are translated. Source on GitHub at commit 0046368

Read the spec205 words, quoted from the repository at commit 0046368.

This NIP defines kind:39701 for a URI as editable web bookmark.

Format

The format uses kind:39701.

The .content should be a detailed description of the web bookmark. It can be an empty string.

The d tag is just their URI. All characters before the hostname should be omitted if the scheme is https.

In this way web bookmarks events can be queried by the d tag by clients.

Metadata

Metadata fields can be added as tags to the event as necessary.

  • "t", for "tags"/"hashtags" (i.e. topics about which the event might be of relevance)
  • "published_at", for the timestamp in unix seconds (stringified) of the first time the bookmark was published
  • "title", title about bookmark and can be used as a attribute for the HTML link element

Example

{
  "kind": 39701,
  "id": "d7a92714f81d0f712e715556aee69ea6da6bfb287e6baf794a095d301d603ec7",
  "pubkey": "2729620da105979b22acfdfe9585274a78c282869b493abfa4120d3af2061298",
  "created_at": 1738869705,
  "tags": [
    // Required tags
    ["d", "alice.blog/post"],
    // Optional tags
    ["published_at", "1738863000"],
    ["title", "Blog insights by Alice"],
    ["t", "post"],
    ["t", "insight"]
  ],
  "content": "A marvelous insight by Alice about the nature of blogs and posts.",
  "sig": "36d34e6448fe0223e9999361c39c492a208bc423d2fcdfc2a3404e04df7c22dc65bbbd62dbe8a4373c62e4d29aac285b5aa4bb9b4b8053bd6207a8b45fbd0c98"
}

Replies & Comments

Replies to kind:39701 MUST use kind 1111 events as comments with NIP-22.