Turn a button into a blurred/locked teaser tile
Show a blurred video or photo with a price/FREE caption instead of a plain text button.
Any button can carry a media object that turns its plain label into a teaser tile — a blurred
photo or looping video with a lock icon and a caption (FREE, $5, etc.), the classic "there's
something here" hook. The link, click tracking, and A/B variants keep working exactly as on a
normal button — it's the same button, just a different face.
Attach media to a button
Media is set at button creation time (POST /api/admin/buttons/{domain}/{tier}), inside the
same payload as the button itself:
curl -X POST "https://app.tease.link/api/admin/buttons/links.creator.com/T1" \
-H "Authorization: Bearer $TEASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text_value": "Locked preview",
"url": "https://onlyfans.com/creator",
"icon": "lock.svg",
"media": {
"kind": "video",
"file": "teaser_0123456789abcdef.mp4",
"poster": "teaserp_0123456789abcdef.webp",
"display": "tile",
"ratio": "3:4",
"blur": 0.6,
"lock": true,
"lock_label": "FREE",
"caption": "New drop 🔥"
}
}'The file/poster values reference already-uploaded teaser assets (upload them through the
button's media panel, or the button media upload endpoint) — you don't invent filenames by hand.
| Key | Meaning |
|---|---|
kind | video or image — must match the file extension (.mp4 for video) |
file | The teaser asset filename |
poster | A still frame shown before a video plays (video only) |
display | tile — full-width image/video instead of the label; icon — a tiny looping clip in place of the round icon |
ratio | 1:1, 3:4, 4:3, 9:16, 16:9 |
blur | 0–1 blur strength over the media |
lock, lock_label | Show a lock badge with a short caption (e.g. FREE, $5) |
caption | A short line under the tile, up to 48 characters |
items | Up to 5 additional slides for a mini-gallery on the same tile |
Clear the media and go back to a plain button by omitting media (or sending null) on a
PATCH — the click-through behavior is unaffected either way.
Confirm it worked
Read the button back (GET /api/admin/buttons/{domain}/{tier}) and check its media field is
populated, then look at the published (or preview) page: the button should render as a tile or
icon-clip instead of a text label, and clicking it should still land on the same URL and be
counted the same way in click stats.
Cosmetic, not a real paywall
The blur and lock are presentation only — anyone who clicks goes to the same destination a plain button would. It's a hook to make someone click, not access control.
What's next
- Build a teaser card stack/carousel for a whole deck of these instead of one button
- Style every button on the landing page
- Back to Landing-page builder