Skip to content
Entity Info guildBanner

$guildBanner[] — Server Banner

$guildBanner[guildID] returns the URL of the banner of the Discord server whose ID is given. To read the banner of the current server without giving its ID, use $serverBanner.

Syntax

$guildBanner[guildID]

Parameters

Parameter Description
guildID The ID of the server. Required: $guildBanner without brackets or with empty brackets is refused.

Return Value

  • Type : string
  • The URL of the banner, or an empty string if the server has no banner.
  • The error Invalid guild ID. is raised if the ID is empty or is not a positive integer, and Guild not found. if the server cannot be fetched.

Examples

Embed with banner

$title[$guildName]
$description[$serverDescription]
$image[$guildBanner[$guildID]]
$thumbnail[$guildIcon]
$color[#5865F2]

Fallback to icon if no banner

$if[$guildBanner[$guildID]!=]
$var[headerImage;$guildBanner[$guildID]]
$else
$var[headerImage;$guildIcon]
$endif
$title[$guildName]
$image[$var[headerImage]]
$color[#5865F2]

Notes

  • $serverBanner returns the banner of the current server and accepts an optional server ID.
  • If the server has no banner, the function returns an empty string.
  • The URL is a https://cdn.discordapp.com/banners/<guildID>/<hash> link ending in .png, or .gif when the banner hash starts with a_ (animated).

Try it

Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.