Skip to main content

Manage properties, calendars, and tags

Three more Toolkit building blocks help you parameterize, schedule around holidays, and organize your work. Each has its own tab below: Properties for reusable values, Calendars for days to skip, and Tags for labels you group and search by.

What this solves

Paths, environment names, and secrets get hard-coded into individual jobs, so one change means editing many places, and credentials end up sitting in plain job definitions.

Properties​

Properties: reusable values​

A property is a named value (like a path or an environment name) you can reuse across jobs instead of hard-coding it. Mark a property encrypted to store a secret safely.

To create a property, complete the following steps:

  1. Go to Toolkit, open the Properties tab, and select New Property.
  2. Set its Name and Value.
  3. Turn on Encrypted if it's a secret, and save.
info

An encrypted property's value is hidden after saving. That's expected. Use encrypted properties for credentials instead of putting secrets in job parameters.

caution
Don't start a property name with $

The $ prefix belongs to the platform's own system properties, and a bare $ name in a token is routed to the scope that owns it rather than looked up among your properties. So a property you call $JOB REPORT won't answer [[$JOB REPORT]] — it comes back unresolved. Name it without the $.

Leaving a value empty, and clearing one​

An empty value is allowed, and it means the setting is deliberately unset — a token naming the property resolves to an empty string rather than failing. The list shows it as (empty), so you can tell it apart from a value that was withheld. That is not the same as deleting the property: a token naming a property that doesn't exist fails the job it was written into. In a message — an event a job fires, or a notification — the same token comes through unresolved and the message is still sent. An event somebody submits from outside a job — from the self-service portal or the API, say — is the other case that stops: that event fails, naming the token.

To empty an encrypted property's value, use Clear stored value in its dialog and then save. You can't do it by blanking the field, because the field starts blank — its stored value is never shown — so a blank you simply left alone means "keep it".

Turning Encrypted off asks you for a new value

A stored encrypted value is never decrypted, so switching Encrypted off won't read one back for you. The save wants a new value to store as plaintext instead, and Save stays unavailable until you type one. Whatever you type is then visible to anyone who can view the property, and in reports.

Clear stored value isn't a way around that — a clear keeps the property encrypted, so the action is hidden while Encrypted is off. Emptying a value and un-encrypting one are two separate jobs.

Good to know
  • Properties are workspace-scoped; calendars and tags are shared across workspaces.
  • Tags power filtering and global search, so a consistent tag scheme pays off at scale.
  • All three are tabs of the one Toolkit page, and each is created and edited in a dialog over its list. Save stays off until you've changed something, and a link straight to an item opens it.
  • Properties are the one Toolkit type with no Cross Reference view, so their delete runs no reference check. Check a property isn't still named by a token before removing it — a token naming a property that doesn't exist fails the job when it's dispatched.

Related topics