Embeds v3

Embeds v3 is the look of the official Voznest hub, now open to everyone. It builds on Embeds v2 (Blocks): every v2 block still works, and v3 adds animated gradient cards, icons instead of emoji, and seven new blocks. Use it in any hub, in DMs and from webhooks — no extra permission beyond the ones v2 needs.

Design and test it in the Embed Studio: pick a theme or your own colors, browse every icon, start from the v3 templates and copy the code.

Themes and your own gradients

Give a container (or a hero) a theme and it gets an animated gradient frame and glow. Everything inside picks up the colors: feature chips, step markers, timeline dots, quote bars, ratings and separators with style: "gradient".

Icons

Wherever v2 takes an emoji, v3 takes an icon: a name from a set of 326 icons (Lucide names). Unknown names are rejected, so typos surface immediately. Browse and copy them in the Studio.

New blocks

Sending v3

Exactly like v2: a blocks array in a message, an edit, an interaction reply or a webhook. The same limits apply (12 top-level blocks, 80 in total, 4 levels, 10,000 characters, 25 controls).

await ctx.reply({  blocks: [{    type: "container",    theme: "sunset",                 // a preset…    // gradient: ["#ff0080", "#7928ca"], // …or your own 2–3 colors    // animated: false,              // a still gradient    blocks: [      { type: "hero", eyebrow: "New season", title: "Season 4 is live", icon: "rocket",        imageUrl: "https://example.com/banner.webp" },      { type: "features", items: [        { icon: "trophy", title: "Ranked", text: "Seven tiers, seasonal rewards." },        { icon: "map", title: "3 new maps", text: "Harbor, Dunes, Skyline." },      ] },      { type: "timeline", items: [        { time: "Mon", title: "Beta", done: true },        { time: "Fri", title: "Launch", icon: "rocket" },      ] },      { type: "rating", value: 4.8, label: "Player rating", count: "12.4k reviews" },    ],  }],});

With the SDK

The SDK (voznest.mjs) has builders for every v3 block: themed, hero, features, steps, timeline, quote, cards and rating, plus the list of themes.

import { botFromEnv, blocks as b } from "./voznest.mjs";const bot = botFromEnv();bot.command({ name: "season", description: "What's new" }, (ctx) =>  ctx.reply({    blocks: [      b.themed("sunset",        b.hero("Season 4 is live", { eyebrow: "New season", icon: "rocket" }),        b.features([["trophy", "Ranked", "Seven tiers"], ["map", "3 new maps", "Harbor, Dunes, Skyline"]]),        b.timeline([["Mon", "Beta"], ["Fri", "Launch"]]),        b.rating(4.8, { label: "Player rating" }),      ),      b.themed(["#ff0080", "#7928ca"], b.quote("Best update yet.", { author: "Ana" })),    ],  }),);await bot.start();

From a webhook

curl -X POST "https://api.voznest.com/api/v1/webhooks/<id>/<token>" \  -H "Content-Type: application/json" \  -d '{"blocks":[{"type":"container","theme":"emerald","blocks":[        {"type":"header","icon":"rocket","title":"Deploy finished","subtitle":"v2.4.0 is live"},        {"type":"steps","items":[{"icon":"check","title":"Build"},{"icon":"check","title":"Tests"},{"icon":"rocket","title":"Release"}]}]}]}'

Channel icons

Any hub can now give a channel one of the same icons, shown in the channel list instead of the usual type icon. Pick it in Channel settings → General → Icon, or send icon when creating or editing a channel (PATCH https://api.voznest.com/api/v1/channels/:id with { "icon": "rocket" }; null goes back to the default). It needs manageChannels.

Good to know

• v2 messages keep rendering exactly as before; adding a theme to a container is all it takes to move one to v3.
• Text inside every block goes through the hub's AutoMod like any message.
• Images and links must be http(s). Card links open in the member's browser.
• POST https://api.voznest.com/api/v1/blocks/validate checks v3 layouts too, without sending anything.