Variables & placeholders

Blood’s base variables work in createembed plain content, embed text, colors, and image URLs. Features that accept Blood message or embed code can also resolve them when they provide the required Discord context. Feature-specific commands can expose additional placeholders of their own; for example, use ,levels message placeholders for level-message values.

Copy the full token, including both braces, and place it where you want the value. Blood resolves it when the message is sent, so {user.display_name} reflects the relevant member at that moment. Variable names are exact; do not add spaces inside the braces.

Member, server, and channel values depend on the command or event that sends the message. Optional Discord values—such as a banner, nickname, topic, or boost time—can be absent. Test the finished message in its real feature and provide surrounding text that still reads naturally when an optional value is unavailable.

A variable such as {user.mention} resolves to Discord mention text. Whether it sends a notification also depends on the feature’s allowed-mentions rules and the channel’s permissions. Preview and test messages before using them publicly. Variables never grant extra Discord permissions or bypass role hierarchy.

This searchable list and the embed builder are generated from the same registry used by ,createembed placeholders. The current base registry contains 108 variables across six groups. If a value is not listed here or by a feature-specific placeholder command, do not assume Blood supports it.