Custom Templates

Custom templates allow you to provide your teammates with customizable experiments, that can be used in your organization with little to no configuration. It’s like being able to create your own starters.

Creating a template

From the templates page External link will open in a new tab, click the New template button.

Upload an experiment

Then, you need to upload or paste a JSON file describing a Chaos Toolkit experiment.

Screenshot showing an experiment pasted in the Reliably UI

This template must declare a configuration property. This property will allow Reliably to define which values will be made editable in the template.

Example of a configuration property in a JSON experiment.

"configuration": {
  "reliably_latency": {
    "key": "RELIABLY_PARAM_LATENCY",
    "type": "env",
    "default": 0.2
  },
  "reliably_service_url": {
    "key": "RELIABLY_PARAM_SERVICE",
    "type": "env",
    "default": "https://example.com"
  }
}

Edit template metadata and fields.

Once the experiment has been uploaded, Reliably asks you to provide a title for your template, as well as optional labels. These labels will be used to allow users to search for specific templates.

The UI for providing a title and labels

Reliably will then present you with a field-description block for each entry in your configuration property.

The UI for describing a field that will be presented to users

Each block consists of two sections. The left-hand side section is a form prompting you to provide a title for the field, the expected data type (string, number, boolean, or a JSON object), as well as an optional default value, and define if this data is required or optional. The right-hand side section displays a preview of the field as it will appear to users, as well as a reminder of the configuration item they will be overriding.

Using a template

On the templates list page, select an existing template.

The list displays a single template, titled Simple Latency Verification

You will then be brought to the template’s detailed view, with its title, description and a preview of the editable fields.

Clicking the Create an experiment from this template button will bring you to the experiment creation form.

On this page, you can edit the experiment title, its description, and fill in the required data. After you click the Save experiment button, the experiment will be visible in the experiments list External link will open in a new tab and will be available for your plans.