Skip to content
Entity Info serverIcon

$serverIcon[] — Server Icon

$serverIcon[] returns the URL of the icon of the current Discord server, or of another server when its ID is given. If the server does not have a custom icon, the function returns an empty string.

Syntax

$serverIcon[(Guild ID)]

Parameters

Parameter Description
Guild ID Optional. The server to read. If omitted or empty, the current server is used. A non-numeric or non-positive value raises Invalid guild ID.

Return Value

  • Type: string
  • The URL of the server icon (https://cdn.discordapp.com/icons/<guildID>/<hash>.png, or .gif when the icon hash starts with a_), or an empty string if no icon is set.
  • The server is fetched from Discord; if it cannot be fetched the error Guild not found. is raised.

Examples

Icon in an embed

$title[$serverName]
$description[Here is the icon of our server]
$image[$serverIcon]
$color[#5865F2]

Thumbnail in a welcome message

$title[Welcome!]
$thumbnail[$serverIcon]
$description[Welcome to $serverName, $username!]
$addField[Members;$membersCount;yes]
$color[#2ECC71]

Check if the server has an icon

$if[$serverIcon==]
  $sendMessage[This server does not have a custom icon.]
$else
  $sendMessage[Icon of the server: $serverIcon]
$endif

Icon of another server

$image[$serverIcon[123456789012345678]]
$footer[$serverName;$serverIcon]
$description[Official message from the server]
$color[#F1C40F]

Notes

  • $serverIcon takes at most one argument, the server ID. $guildIcon[(guildID)] is a different function that does not raise an error when the server cannot be fetched.
  • If the server does not have an icon, the function returns an empty string ("").
  • The URL can be used in $image[], $thumbnail[] or $footer[].

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.