← All NIPs

NIP-92

Media Attachments Metadata (imeta)

DraftEvents

When a note links to an image or video, an imeta tag describes that file (type, size, dimensions, hash, alt text) so clients can show a good preview before downloading it.

Status
In use and still allowed to change.
Tags
  • imeta
Last changed
Jun 2, 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

The note's text, including each media URL.

Tags

  1. imeta Recommended

    Metadata for one URL found in content.

Add tag

How this NIP works

Step 1 of 4

Put the URL in the text

The media URL stays in content, so any client can still show a plain link.

In the course

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

Builds on

Used by

See also

  • NIP-B7 Blossom

    Blossom servers return the metadata clients turn into imeta tags.

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 spec226 words, quoted from the repository at commit 0046368.

Media attachments (images, videos, and other files) may be added to events by including a URL in the event content, along with a matching imeta tag.

imeta ("inline metadata") tags MAY add information about media URLs in the event's content. Each imeta tag SHOULD match a URL in the event content. Clients MAY replace imeta URLs with rich previews.

The imeta tag is variadic, and each entry is a space-delimited key/value pair. Each imeta tag MUST have a url, and at least one other field. imeta MAY include any field specified by NIP 94. There SHOULD be only one imeta tag per URL.

Example

{
  "content": "More image metadata tests don’t mind me https://nostr.build/i/my-image.jpg",
  "kind": 1,
  "tags": [
    [
      "imeta",
      "url https://nostr.build/i/my-image.jpg",
      "m image/jpeg",
      "blurhash eVF$^OI:${M{o#*0-nNFxakD-?xVM}WEWB%iNKxvR-oetmo#R-aen$",
      "dim 3024x4032",
      "alt A scenic photo overlooking the coast of Costa Rica",
      "x <sha256 hash as specified in NIP 94>",
      "fallback https://nostrcheck.me/alt1.jpg",
      "fallback https://void.cat/alt1.jpg"
    ]
  ]
}

When uploading files during a new post, clients MAY include this metadata after the file is uploaded and included in the post.

When pasting URLs during post composition, the client MAY download the file and add this metadata before the post is sent.

The client MAY ignore imeta tags that do not match the URL in the event content.