Personalization Reference

Options for personalizing your Battlesnake's appearance


This reference outlines all the available options for personalizing your Battlesnake's appearance. We periodically release new options, often linked to specific events or competitions.

Each Battlesnake can choose a color, head, and tail to represent it on the game board. Here's an example of a full personalized Battlesnake.

"color": "#736CCB",
"head": "beluga",
"tail": "curled"

This configuration will display your Battlesnake like this:

Choosing a Color

Your Battlesnake can choose any valid six-digit hex color code to represent it on the game board. This value is provided in response to the GET / command of the Battlesnake API and should be a 7 character string starting with "#" that looks similar to "#33CC00".

You can use an HTML Color Picker Tool to help you find the exact color you're looking for.

Some Example Battlesnake Colors


Choosing a Head and Tail

Several personalization options are available for how your Battlesnake's head and tail will display on the game board. You can mix and match them however you like.

Just like choosing a color, your head and tail are provided in response to the GET / command of the Battlesnake API. Each value is a string, matching one of the available options shown below.

If an invalid value is returned (or no value at all) the default options will be displayed.

New Theme Releases We regularly release new head and tail options, often as part of specific Battlesnake events and competitions.

Default Theme

If your Battlesnake doesn't specify a head or tail these default options will be used.

default head and tail

Standard Theme

These were the first heads and tails ever released, as part of Battlesnake Victoria 2018. They hold a special spot in all our hearts.

Standard Heads

beluga, bendr, dead, evil
fang, pixel, sand-worm, safe
shades, silly, smile, tongue

Standard Tails

block-bum, bolt, curled, fat-rattle
freckled, hook, pixel, round-bum
sharp, skinny, small-rattle

Winter Classic 2019 Theme

Released for the first ever Battlesnake Winter Classic event, in November 2019.

Winter Classic 2019 Head

bonhomme, earmuffs, rudolph, scarf
ski, snow-worm, snowman

Winter Classic 2019 Tails

bonhomme, flake, ice-skate, present

Stay Home and Code Theme

Released as part of our Stay Home and Code event in April 2020, raising money for Food Banks Canada.

Stay Home and Code Heads

caffeine, gamer, workout, tiger-king

Stay Home and Code Tails

coffee, mouse, weight, tiger-tail

Fall League and Winter Classic 2020 Theme

Released as part of the Battlesnake Fall League competition in 2020. These customizations are limited edition and can only be earned by participating in the competition.

Fall League 2020 Heads

jackolantern, pumpkin

Fall League 2020 Tails