# Unique Email

Generates unique email addresses. Replaces the username with a randomly generated GUID, and masks the domain with a character scramble.

This generator only guarantees uniqueness if the underlying column is unique.

## Characteristics <a href="#unique-email-characteristics" id="unique-email-characteristics"></a>

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Consistency</strong></td><td valign="top">Yes, can be made self-consistent.</td></tr><tr><td valign="top"><strong>Linking</strong></td><td valign="top">No, cannot be linked.</td></tr><tr><td valign="top"><strong>Differential privacy</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Data-free</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Allowed for primary keys</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Allowed for unique columns</strong></td><td valign="top">Yes</td></tr><tr><td valign="top"><strong>Uses format-preserving encryption (FPE)</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Privacy ranking</strong></td><td valign="top"><ul><li>3 if not consistent</li><li>4 if consistent</li></ul></td></tr><tr><td valign="top"><strong>Generator ID (for the API)</strong></td><td valign="top"><a href="../../../api/quick-start-guide/tonic-api-generator-assignment/generator-api-reference/generator-api-ref-unique-email"><code>UniqueEmailGenerator</code></a></td></tr></tbody></table>

## How to configure <a href="#unique-email-configure" id="unique-email-configure"></a>

To configure the generator:

1. In the **Email Domain** field, enter a domain to use for all of the output values.\
   \
   For example, you might use `@mycompany.com` for all of the generated values.\
   \
   If you do not provide a value, then the generator uses a character scramble on the domain.
2. In the **Excluded Email Domains** field, enter a comma-separated list of domains for which Structural does not mask the email addresses.\
   \
   This allows you, for example, to maintain internal or testing email addresses that are not considered sensitive.
3. Toggle the **Replace invalid emails** setting to indicate whether to replace an invalid email address with a generated valid email address.\
   \
   By default, invalid email addresses are not replaced.\
   \
   In the replacement values, the username is generated. If you specify a value for **Email Domain**, then that value is used for the domain. Otherwise, the domain is generated.
4. Toggle the **Consistency** setting to indicate whether to make the generator self-consistent.\
   \
   By default, consistency is disabled.
5. If [Structural data encryption](https://docs.tonic.ai/app/generation/generators-assign-config/generators-data-encryption-config) is enabled, then to use it for this column, in the advanced options section, toggle **Use data encryption process** to the on position.


---

# 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/unique-email.md?ask=<question>
```

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.
