Personalization Reference

Options for personalizing your Battlesnake's appearance

Introduction

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.

snake-personalization.json
{
"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

#E80978
#3E338F
#4C89C8

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, bender, dead, evil
fang, pixel, sand-worm, safe
shades, silly, smile, tongue

Standard Tails

block-bum, bolt, curled, fat-rattle
freckle, 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

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

Winter Classic 2019 Tails

bwc-bonhomme, bwc-flake, bwc-ice-skate, bwc-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

shac-caffeine, shac-gamer, shac-workout, shac-tiger-king

Stay Home and Code Tails

shac-coffee, shac-mouse, shac-weight, shac-tiger-tail