# Conditional This is a [composite generator](https://docs.tonic.ai/app/generation/generators/generator-types/generators-composite). Applies different generators to the value conditionally based on any value in the table. For example, a Users table contains Name, Username, and Role columns. For the Username column, you can use a conditional generator to indicate that if the value of Role is something other than Test, then use the Character Scramble generator for the Username value. For Test users, the name is not masked. ## Characteristics


Consistency	Determined by the selected generators.
Linking	Determined by the selected generators.
Differential privacy	Determined by the selected generators.
Data-free	Determined by the selected generators.
Allowed for primary keys	Yes, but: Make sure that the configuration preserves uniqueness. Do not use on primary key columns that are used for subsetting.
Allowed for unique columns	Yes
Uses format-preserving encryption (FPE)	No
Privacy ranking	If a fallback generator is selected, then the lower of either 5 or the fallback generator. 5 if no fallback generator is selected
Generator ID (for the API)	`ConditionalGenerator`

## How to configure The generator consists of a list of options. Each option includes the required conditions and the generator to use if those conditions are met. ### Setting the default generator The generator always contains a **Default** option. The **Default** option is used if the value does not meet any of the conditions. To configure the **Default** option: 1. From the **Default** dropdown list, select the generator to use by default. 2. Configure the selected generator. ### Adding a condition option To add a condition option: 1. Click **+ Conditional Generator**. 2. To add a condition: 1. Click **+ Condition**. 2. From the column list, select the column for which to check the value. 3. Select the comparison type. 4. Enter the column value to check for. To remove a condition, click the delete icon for the condition. 3. From the **Generator** dropdown list, select the generator to run on the current column if the conditions are met.\ \ You cannot select another composite generator. 4. Choose the configuration options for the selected generator. ### Viewing and editing condition options To view details for and edit a condition option, click the expand icon for that option. ### Removing a condition option To remove a condition option, click the delete icon for the option. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.tonic.ai/app/generation/generators/generator-reference/conditional.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.