Server labels

Go to a server's Labels tab. Label a server with anything you want to group it by — a game, an environment, a team, a cost centre — then search the server list by a label's value to find every server carrying it. This is how you build your own groupings, independently of your organizational structure.

Adding a label

1

Open the Labels tab

Open the server from the Servers page and choose Labels.

2

Add a label

Click Add label in the Your labels card.

3

Enter a key and a value

The key is the category (environment, game, team); the value is this server's entry in it (production, my-game, platform).

4

Save

The label appears in Your labels straight away.

Changing and removing a label

In Your labels, click a label's value to edit it in place. To remove one entirely, use Delete label on its row.

If you add a label with a key that already exists on the server, the dialog says so and the button changes to Replace label — so you replace the existing value rather than creating a second entry for the same key.

The rules

Rule	Limit
Labels per server	50 that you create
Key length	Up to 50 characters
Value length	Up to 150 characters
New key format	Lowercase letters, digits, - and _. Must start with a letter.
Value	Anything except the literal word null

The card header counts what you've used (12 of 50). At the limit you can still change and delete the labels already there, but not add another.

A handful of keys are reserved for the i3D.net platform and can't be used for your own labels: application_build_id, application_id, dc_location_id, fleet_id, host_id, region_id and region_name.

Keys are matched case-insensitively, so Environment and environment are the same key. The key is displayed the way you typed it.

Set automatically

Below your own labels, a Set automatically card shows labels i3D.net maintains — they record where the server sits in our platform and are kept up to date for you. They're read-only, they don't count towards your 50-label limit, and a server-list search never matches them.

Where a server isn't reserved for a fleet, fleet_id and region_id read Currently not reserved for a fleet.

Finding servers by label

On the Servers page, search for a label's value. Servers that match on a label show the matching label as a chip beneath the server name, with the matched text in bold — so you can see why each row is in the results. Up to two chips show per row, then +N more.

Search matches label values, not keys. To find every production server, search for production, not environment.

Labels and the API

Labels are part of the i3D.net API, so you can keep them in step with your own tooling rather than setting them by hand. See the Host Label API documentation.

Related topics

• Server details

• The Servers page