# State Testing

Executing a Salt state run can potentially change many aspects of a system and it may be desirable to first see what a state run is going to change before applying the run.

Salt has a test interface to report on exactly what will be changed, this interface can be invoked on any of the major state run functions:

    salt '*' state.highstate test=True
    salt '*' state.sls test=True
    salt '*' state.single test=True

The test run is mandated by adding the `test=True` option to the states. The return information will show states that will be applied in yellow and the result is reported as `None`.

## Default Test

If the value `test` is set to `True` in the minion configuration file then states will default to being executed in test mode. If this value is set then states can still be run by calling test=False:

    salt '*' state.highstate test=False
    salt '*' state.sls test=False
    salt '*' state.single test=False

Current Salt release: 0.17.1

### Table Of Contents

- State Testing
  - Default Test

#### Previous topic

Startup States

#### Next topic

The Top File

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd