Skip to content

Variables and environments ​

Write {{name}} in the URL, headers, body or auth, and FleetFoot puts the value in when it sends the request.

Where values come from ​

When the same name is defined in several places, the first one wins:

  1. the active environment, chosen at the top right;
  2. the collection variables (right-click the collection → Variables);
  3. Globals (in the Environments section of the sidebar).

A value can use other variables, for example baseUrl = https://{{host}}/api.

How variables look ​

  • {{defined}} — has a value. Hover it to see the value and where it comes from.
  • {{undefined}} — has no value; it is sent as is.

Type {{ to get a list of the variables you can use. The eye button at the top right shows every variable in scope; secret values are hidden until you choose to show them.

Define undefined variables ​

When a request uses variables without values, its header shows N undefined. Click it, or Define… in the tooltip of a red variable, to give them values. For a whole collection, right-click it → Undefined variables….

In the dialog, type the values and choose where to save them: a new environment (it becomes active), an existing one, the collection or globals. Names that look like tokens or passwords are marked secret.

Environments ​

Create an environment in the Environments section of the sidebar. Click its circle to make it active, or choose it at the top right. Mark a variable as secret with the lock button to hide its value on screen.

Dynamic variables ​

These get a new value on every send:

VariableValue
{{$guid}}, {{$randomUUID}}a random UUID
{{$timestamp}}Unix time in seconds
{{$isoTimestamp}}the current time in ISO 8601
{{$randomInt}}a number from 0 to 1000
{{$randomBoolean}}true or false
{{$randomAlphaNumeric}}one letter or digit
{{$randomHexColor}}a color like #a1b2c3
{{$randomEmail}}an e-mail address

FleetFoot: everything stays on your Mac.