ENS-KIT/1Draft

Text Record Extension Spec

A proposed convention for driving frontend UI directly from ENS text records. Compatible with any ENS name — no custom resolver required. Updates are instant, gasless, and require no redeployment.

Reference implementation: dinamic.eth · ens-dynamic-kit

Media

Key	Format	Behaviour
avatar	URL or ipfs:// ipfs://Qm...	Profile picture
icon	URL or ipfs:// (SVG/PNG) ipfs://Qm...	Site icon — nav badge + browser tab favicon
video	URL or ipfs:// https://...	Looping background video
banner	URL or ipfs:// ipfs://Qm...	Hero banner image
gallery	Comma-separated URLs ipfs://Qm...,ipfs://Qm...	Photo / media grid
card_bg	URL or ipfs:// ipfs://Qm...	Background image on the profile card
media	URL or ipfs:// (img/video) ipfs://Qm...	Full-width media card below the page title
media_desc	Text My latest project	Caption shown below the media card

Actions

Key	Format	Behaviour
pfp_button	Label\|URL or URL Hire me\|https://cal.com/me	Primary CTA button. Label defaults to "Visit"
pfp_button_2	Label\|URL or URL Portfolio\|https://...	Secondary CTA button
url	URL https://mysite.com	Fallback CTA "Visit Site" when pfp_button unset
tip	ETH address 0x123...	Send-tip button that opens a wallet transfer
donate	ETH address 0x123...	Centered pill at page bottom — click to copy address
cal	Calendly / Cal.com URL https://cal.com/me	"Book a call" button

Integrations

Key	Format	Behaviour
com.twitter	Handle or full URL @handle	Social badge + tag
com.github	Username myuser	Social badge + tag
discord	Handle or invite URL user#1234	Social badge
telegram	Handle @handle	Social badge
email	Email address me@example.com	Contact link
rss	Feed URL https://blog.me/rss.xml	Latest posts widget

Appearance

Key	Format	Behaviour
theme	dark / light / gradient:<color> gradient:purple	Overrides colour scheme
layout	minimal / full / grid minimal	Page layout variant
badge	Short string Available for work	Status badge on avatar

Conventions

Keys follow existing ENSIP-5 conventions where they exist (com.twitter, com.github, avatar, url, email).
New keys use lowercase with underscores (pfp_button, pfp_button_2).
Multi-value fields use | as separator — label first, URL second.
All URL fields accept ipfs:// as well as https://.
Unknown keys are silently ignored — spec is forwards compatible.

← dinamic.eth Admin Panel →