# ERC-5489: NFT Hyperlink Extension

Source: https://www.eipsfordesigners.com/standards/ERC-5489
Agent brief: https://www.eipsfordesigners.com/standards/ERC-5489/agent.md
Machine-readable JSON: https://www.eipsfordesigners.com/api/standards/ERC-5489
Last reviewed: 2026-05-25
Last updated: 2026-05-25

| Field | Value |
| --- | --- |
| Status | Final |
| Chain | both |
| Category | NFT Capabilities |
| Journey stages | Asset Discovery & Display, Specialized Interactions |
| Detailed guide | Yes |
| Official specification | https://eips.ethereum.org/EIPS/erc-5489 |
| Discussion search | https://ethereum-magicians.org/search?q=ERC-5489 |

## UX Impact

NFTs have authorized hyperlink slots — owners grant addresses permission to set links on their tokens. Design implications: show attached hyperlinks on NFT display, indicate slot authorization status, design slot management UI (authorize/revoke addresses), display link metadata (icon, description, target). Design decisions: how prominently to show attached links (ad-like), trust indicators for link destinations, multiple slots management complexity, authorization flow UX.

## Summary

NFTs have authorized hyperlink slots — owners grant addresses permission to set links on their tokens.

## For Designers

- You can show attached links as a curated Links section with icon and description, not raw URLs.
- Your owner settings can authorize or revoke addresses per slot with clear permission scope.
- You can warn on external link click with destination preview before opening new tab.

## Applicability

### When to Use

- NFTs need official links — artist site, merch, license.
- Multiple parties may update different slots.
- On-chain link authorization is required.

### When to Avoid

- Metadata JSON off-chain links suffice.
- No slot management in product scope.
- Cannot vet link destinations safely.

## Problems It Solves

### Anyone could claim fake links in description

Impact: high

Old way: Scam links in off-chain metadata

New way: Authorized setter per slot on-chain

### Official links buried in metadata

Impact: medium

Old way: Users never find artist site

New way: Structured link slots on detail page

### Collaborators need link update without ownership

Impact: medium

Old way: Transfer NFT or share keys

New way: Grant slot authorization to brand address

## Anti-Patterns

### Direct open with no domain preview

Severity: critical

Phishing via authorized compromised setter

Instead: Interstitial showing destination domain

### Banner ads overlaying NFT art

Severity: high

Destroys aesthetic; feels scammy

Instead: Links section below art

### Ten link slots equally prominent

Severity: medium

Link farm appearance

Instead: Cap visible slots; manage overflow in settings

## Design Decisions

### How prominent are links?

Recommendation: Below fold Links section, not overlay on art.

Rationale: Ad-like overlays hurt aesthetic and trust.

### Show raw URL?

Recommendation: Description primary; URL on hover or expand.

Rationale: Raw URLs look like phishing.

### Multiple slots UI?

Recommendation: Max 3 visible plus Manage slots for owner.

Rationale: Slot sprawl looks spammy.

## States to Design

### Links displayed

Trigger: Slots filled.

User need: Scan official resources.

Design response: Curated link cards below art.

### Empty slot

Trigger: Authorized but unset.

User need: Owner or setter knows to fill.

Design response: Empty slot dashed card for authorized users only.

### Unauthorized edit attempt

Trigger: Non-setter tries update.

User need: Clear block.

Design response: You are not authorized for this slot.

### Revoked setter

Trigger: Owner revoked address.

User need: Setter knows access ended.

Design response: Access removed; existing link may remain until cleared per rules.

### External click

Trigger: Viewer clicks link.

User need: Safe navigation.

Design response: Interstitial with domain highlight.

## Vocabulary

- Use "Official links" instead of "Hyperlink slots": Curatorial not technical.

- Use "Allow [brand] to update link" instead of "Authorize slot setter": Permission plain language.

- Use "You are leaving for [domain]" instead of "External URI navigation": Safety interstitial copy.

## What to Prototype First

### NFT links section

Visitors discover official related URLs from token page.

Covers: One link, Multiple slots, Empty slots

- Link cards with icon
- Description
- External link icon
- Empty slot placeholder

### Authorize slot setter

Owner delegates who can set link without transferring NFT.

Covers: Authorize, Revoke

- Slot picker
- Address field
- Permission summary
- Revoke list

### Set link as authorized party

Brand or collaborator updates their slot.

Covers: Edit link, Submit

- URL field
- Icon upload
- Description
- Preview card

### External link safety interstitial

Phishing risk on any clickable URL.

Covers: Leaving site warning

- Destination domain
- Continue button
- Report link

## Mental Model

### Hyperlink slot

Fixed position on NFT for one curated link.

### Authorized setter

Only listed addresses can update that slot.

### Owner control

Owner grants/revokes setter permissions per slot.

### Link metadata

Icon and description make links trustworthy and scannable.

### Viewer trust

Links appear official because setter was authorized.

## Seen in the Wild

- OpenSea: External links section on collection pages. (https://opensea.io/)

- Zora: Creator profile links on token pages. (https://zora.co/)

- Foundation: Artist attribution and link patterns. (https://foundation.app/)

## On Monad

### Link updates

Ethereum: Slot edits cost gas

Monad: Cheap updates encourage fresh official links

Design implication: Inline link edit for authorized setters on Monad.

### Click-through safety

Ethereum: Same interstitial need

Monad: Same — speed does not reduce phishing risk

Design implication: Always show domain interstitial on Monad.

## UX Patterns

### Curated Link Cards

Icon, description, and safe external open.

Components: LinkCard, DomainPreview, ExternalIcon

User flow:

- View NFT
- See links section
- Click card
- Interstitial
- Opens site

Mockup registry key: `concept/nft-gallery` (React UI on the live standard page).

### Slot Authorization Panel

Owner grants/revokes link setters per slot.

Components: SlotList, AuthorizeForm, RevokeButton

User flow:

- Owner opens settings
- Picks slot
- Authorizes address
- Setter can edit link

Mockup registry key: `concept/verify-safety` (React UI on the live standard page).

## Related Standards

- ERC-721: Hyperlink extension on NFTs

- ERC-5521: Reference graph complements outbound links

## Technical Notes

ERC-5489 slot authorization is per-address; use link interstitials for all external opens.