Skip to main content

​
Overview

bli uses a $b-separated key-value syntax to build embeds inline. Each parameter is a {key: value} block, and blocks are separated by $b. 
{key: value}$b{key: value}$b{key: value}

​
Structure

  • { begins a parameter
  • : separates the key from the content
  • $b separates parameters from each other
  • } ends a parameter

​
Parameters

ParameterDescription
titleEmbed title
descriptionEmbed description
colorEmbed color (#FFFFFF)
urlClickable title URL (https://..)
imageLarge image at the bottom (https://..)
thumbnailSmall image at the top-right (https://..)
timestampAdds current timestamp (no value needed)
messagePlain text content above the embed
The following parameters take multiple arguments separated by &&:
  • name — Author name (required)
  • icon — Author icon URL (optional)
  • url — Author clickable URL (optional)
{author: name && icon && url}
  • name — Field name (required)
  • value — Field value (required)
  • Add inline at the end to make the field inline
{field: name && value}
{field: name && value && inline}
Link button — pass the URL as the first argument:
  • url — The link URL
  • label — Button label
Styled button — pass a color name as the first argument:
  • style — blurple, green, grey, or red
  • label — Button label
{button: https://url.com && label}
{button: style && label}

​
Variables

You can use variables anywhere inside embed values: 
{title: welcome to {guild.name}}$b{description: hey {user.mention}!}$b{color: #f9c8d9}

​
Behavior flags

These can be added anywhere in the message alongside your embed:
FlagDescription
{message: text}Plain content sent above the embed
{noping}Suppress the mention ping
{dm}Send as a DM to the member
{react: emoji}React to the message with an emoji
{delete_reply: 10}Auto-delete the message after N seconds

​
Full example

{message: {user.mention}}$b{title: welcome to {guild.name}!}$b{description: you are member number **{user.join_position_suffix}**}$b{thumbnail: {user.display_avatar}}$b{footer: {guild.name} && {guild.icon}}$b{color: #f9c8d9}$b{timestamp}

​
Building embeds interactively

Use /embed create name:(name) to open the interactive embed builder. Click individual buttons to fill in each field — no manual syntax needed.
Reference a saved embed in welcome/leave/boost messages using {embed:name}.