# Name

Generates a random name string from a dictionary of first and last names.

You specify the name information that is contained in the column. A column might only contain a first name or last name, or it might contain a full name. A full name might be first name first or last name first.

For example, a **Name** column contains a full name in the format **Last, First**. For the input value `Smith, John`, the output value would be something like, `Jones, Mary`.

## Characteristics <a href="#name-characteristics" id="name-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 or consistent with another column.<br><br>Note that all Name generator columns that have the same consistency configuration are automatically consistent with each other. The columns must either be all self-consistent or all consistent with the same other column.<br><br>For example, you can use this to ensure that a first name and last name column value always match the first name and last name in a full name column.</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">Yes, if consistency is not enabled.</td></tr><tr><td valign="top"><strong>Data-free</strong></td><td valign="top">Yes, if consistency is not enabled.</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">No</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>1 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-name"><code>NameGenerator</code></a></td></tr></tbody></table>

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

To configure the generator:

1. From the name format dropdown list, select the type of name value that the column contains:
   * First. This also is commonly used for standalone middle name fields.
   * Last
   * First Last
   * First Middle Last
   * First Middle Initial Last
   * Last, First
   * Last, First Middle
   * Middle Initial
2. Toggle the **Preserve Capitalization** setting to indicate whether to preserve the capitalization of the column value.\
   \
   By default, the capitalization is not preserved.
3. Toggle the **Consistency** setting to indicate whether to make the column consistent.\
   \
   By default, consistency is disabled.
4. If you enable consistency, then by default the generator is self-consistent.\
   \
   To make the generator consistent with another column, from the **Consistent to** dropdown list, select the column.
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.
