---
title: Environment file
description: Learn about the environment.properties file in Allure, used to define environment data for your test reports, with examples and guidelines for proper use.
---

# Environment file

Warning:
This page describes a data format used by Allure and its integrations for test frameworks. Depending on the test framework you use, this file may or may not be generated automatically based on the project configuration. Check [your integration's documentation](/docs/frameworks/).

The `environment.properties` file in the test results directory, if present, defines a set of key-value pairs to display in the test report. See [Environment information](/docs/v2/readability/#environment-information).

The data is stored in the [`.properties`](https://en.wikipedia.org/wiki/.properties) format.

Example:

```properties
os_platform = linux
os_release = 5.15.0-60-generic
os_version = #66-Ubuntu SMP Fri Jan 20 14:29:49 UTC 2023
python_version = Python 3.10.9
```

Note that this feature should be used for properties that do not change for the whole test launch. If you have properties that can be different for different tests, consider using [Parametrized tests](/docs/v2/readability/#parametrized-tests).

## New Environments feature in Allure Report 3

In addition to environment files, Allure Report 3 comes with a much more powerful Environments feature that lets you store more information on environments and create multiple-environment reports. Learn how it works and how to set it up [here](/docs/environments/).