# Profile Fields

When generating person-profile data, you often need several related presets together: a name, an email derived from that name, an address, a phone number, and so on. Rather than wiring up each column individually, the [profile_fields()](../../reference/profile_fields.md#pointblank.profile_fields) helper returns a ready-made dictionary of `StringField` objects that you can unpack directly into a [Schema()](../../reference/Schema.md#pointblank.Schema).

## Basic Usage

With no arguments, [profile_fields()](../../reference/profile_fields.md#pointblank.profile_fields) returns the **standard** set of seven columns: `first_name`, `last_name`, `email`, `city`, `state`, `postcode`, and `phone_number`. All coherence rules apply automatically: emails are derived from names, and city/state/postcode/phone are internally consistent.

``` python
schema = pb.Schema(
    user_id=pb.int_field(unique=True, min_val=1),
    **pb.profile_fields(),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23))
```

| PolarsRows100Columns8 |  |  |  |  |  |  |  |  |
|----|----|----|----|----|----|----|----|----|
|  | user_id *Int64* | first_name *String* | last_name *String* | email *String* | city *String* | state *String* | postcode *String* | phone_number *String* |
| 1 | 7188536481533917197 | Weston | Parker | weston.parker23@gmail.com | Lubbock | Texas | 79404 | \(832\) 960-5399 |
| 2 | 2674009078779859984 | Hazel | Torres | hazel723@hotmail.com | Anaheim | California | 92873 | \(805\) 988-7427 |
| 3 | 7652102777077138151 | Lawrence | Mitchell | lawrence_mitchell@zoho.com | Phoenix | Arizona | 85027 | \(928\) 782-5894 |
| 4 | 157503859921753049 | Maria | Garcia | m_garcia@hotmail.com | Denver | Colorado | 80277 | \(303\) 846-6634 |
| 5 | 2829213282471975080 | Michael | Hoffman | michael.hoffman@gmail.com | San Antonio | Texas | 78208 | \(214\) 901-0009 |
| 96 | 7027508096731143831 | Daniel | Torres | daniel_torres@icloud.com | El Paso | Texas | 79944 | \(281\) 769-2210 |
| 97 | 6055996548456656575 | Helen | Simpson | hsimpson20@yandex.com | El Paso | Texas | 79930 | \(210\) 345-8803 |
| 98 | 3822709996092631588 | Mark | Graham | mark.graham65@mail.com | Charlotte | North Carolina | 28222 | \(336\) 732-4609 |
| 99 | 1522653102058131295 | Brian | Moore | bmoore95@zoho.com | Los Angeles | California | 90058 | \(707\) 702-7905 |
| 100 | 5690877051669225499 | Michael | Ward | michael_ward@yahoo.com | San Diego | California | 92147 | \(619\) 940-2614 |

The `**` operator unpacks the dictionary into keyword arguments, as if you had written each `string_field(preset=...)` call by hand.

## Choosing a Set

Three built-in sets control how many columns are generated:

| Set | Columns |
|----|----|
| `"minimal"` | `first_name`, `last_name`, `email`, `phone_number` |
| `"standard"` | `first_name`, `last_name`, `email`, `city`, `state`, `postcode`, `phone_number` |
| `"full"` | `first_name`, `last_name`, `email`, `address`, `city`, `state`, `postcode`, `phone_number`, `company`, `job` |

``` python
# Minimal profile: just name, email, and phone
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="minimal")),
        n=100, seed=23,
    )
)
```

| PolarsRows100Columns4 |  |  |  |  |
|----|----|----|----|----|
|  | first_name *String* | last_name *String* | email *String* | phone_number *String* |
| 1 | Weston | Parker | weston.parker23@gmail.com | \(214\) 673-2777 |
| 2 | Hazel | Torres | hazel723@hotmail.com | \(213\) 828-0231 |
| 3 | Lawrence | Mitchell | lawrence_mitchell@zoho.com | \(623\) 370-0982 |
| 4 | Maria | Garcia | m_garcia@hotmail.com | \(970\) 694-0476 |
| 5 | Michael | Hoffman | michael.hoffman@gmail.com | \(682\) 391-2143 |
| 96 | Daniel | Torres | daniel_torres@icloud.com | \(915\) 504-6717 |
| 97 | Helen | Simpson | hsimpson20@yandex.com | \(940\) 869-0705 |
| 98 | Mark | Graham | mark.graham65@mail.com | \(984\) 800-0885 |
| 99 | Brian | Moore | bmoore95@zoho.com | \(650\) 955-2724 |
| 100 | Michael | Ward | michael_ward@yahoo.com | \(949\) 771-2134 |

``` python
# Full profile: includes address, company, and job title
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="full")),
        n=100, seed=23,
    )
)
```

| PolarsRows100Columns10 |  |  |  |  |  |  |  |  |  |  |
|----|----|----|----|----|----|----|----|----|----|----|
|  | first_name *String* | last_name *String* | email *String* | address *String* | city *String* | state *String* | postcode *String* | phone_number *String* | company *String* | job *String* |
| 1 | Weston | Parker | wparker89@outlook.com | 3365 Richmond Avenue, Suite 422, Lubbock, Texas 79421 | Lubbock | Texas | 79470 | \(210\) 460-3732 | Patterson Networks | System Administrator |
| 2 | Hazel | Torres | htorres35@aol.com | 353 East South Street, Anaheim, California 92898 | Anaheim | California | 92835 | \(858\) 514-0644 | Anaheim Real Estate | Insurance Agent |
| 3 | Lawrence | Mitchell | lawrence.mitchell1@hotmail.com | 2647 Tatum Boulevard, Phoenix, Arizona 85023 | Phoenix | Arizona | 85041 | \(520\) 301-6749 | Ford | Interior Designer |
| 4 | Maria | Garcia | mgarcia@aol.com | 5145 Arizona Avenue, Apt 761, Denver, Colorado 80255 | Denver | Colorado | 80287 | \(970\) 458-9509 | Carter Electric | HVAC Technician |
| 5 | Michael | Hoffman | m_hoffman@outlook.com | 5209 Grayson Street, Suite 333, San Antonio, Texas 78299 | San Antonio | Texas | 78248 | \(512\) 529-7287 | San Antonio Engineering Group | Construction Manager |
| 96 | Daniel | Torres | daniel.torres48@icloud.com | 3678 Rim Road, Suite 33, El Paso, Texas 79943 | El Paso | Texas | 79962 | \(972\) 892-8539 | Pioneer Strategy Group | Consultant |
| 97 | Helen | Simpson | helen.simpson1@hotmail.com | 1411 Mesa Street, El Paso, Texas 79930 | El Paso | Texas | 79955 | \(512\) 481-0603 | Powell & Gordon | Electrical Engineer |
| 98 | Mark | Graham | mgraham26@mail.com | 2065 Craighead Road, Apt 521, Charlotte, North Carolina 28289 | Charlotte | North Carolina | 28261 | \(980\) 608-7729 | Graham & Allen | Mechanical Engineer |
| 99 | Brian | Moore | brian263@icloud.com | 2072 2nd Street Los Angeles, Suite 893, Los Angeles, California 90034 | Los Angeles | California | 90037 | \(408\) 625-2327 | The Quality Hotels | Chef |
| 100 | Michael | Ward | m_ward@protonmail.com | 7966 K Street, San Diego, California 92109 | San Diego | California | 92194 | \(510\) 252-2820 | Morgan Stanley | Bank Teller |

## Combined vs. Split Names

By default, names are split into `first_name` and `last_name` columns. Set `split_name=False` to get a single `name` column instead:

``` python
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="minimal", split_name=False)),
        n=100, seed=23,
    )
)
```

| PolarsRows100Columns3 |  |  |  |
|----|----|----|----|
|  | name *String* | email *String* | phone_number *String* |
| 1 | Weston Parker | weston.parker23@gmail.com | \(214\) 673-2777 |
| 2 | Hazel Torres | hazel723@hotmail.com | \(213\) 828-0231 |
| 3 | Lawrence Mitchell | lawrence_mitchell@zoho.com | \(623\) 370-0982 |
| 4 | Maria Garcia | m_garcia@hotmail.com | \(970\) 694-0476 |
| 5 | Michael Hoffman | michael.hoffman@gmail.com | \(682\) 391-2143 |
| 96 | Daniel Torres | daniel_torres@icloud.com | \(915\) 504-6717 |
| 97 | Helen Simpson | hsimpson20@yandex.com | \(940\) 869-0705 |
| 98 | Mark Graham | mark.graham65@mail.com | \(984\) 800-0885 |
| 99 | Brian Moore | bmoore95@zoho.com | \(650\) 955-2724 |
| 100 | Michael Ward | michael_ward@yahoo.com | \(949\) 771-2134 |

## Adding and Removing Columns

Use `include=` to add presets to the base set and `exclude=` to remove them. Both accept lists of preset names. The available profile presets are: `first_name`, `last_name`, `name`, `email`, `address`, `city`, `state`, `postcode`, `phone_number`, `company`, and `job`.

``` python
# Standard set + company column
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(include=["company"])),
        n=100, seed=23,
    )
)
```

| PolarsRows100Columns8 |  |  |  |  |  |  |  |  |
|----|----|----|----|----|----|----|----|----|
|  | first_name *String* | last_name *String* | email *String* | city *String* | state *String* | postcode *String* | phone_number *String* | company *String* |
| 1 | Weston | Parker | weston.parker23@gmail.com | Lubbock | Texas | 79404 | \(832\) 960-5399 | Innovative Systems Solutions |
| 2 | Hazel | Torres | hazel723@hotmail.com | Anaheim | California | 92873 | \(805\) 988-7427 | Sterling Engineering |
| 3 | Lawrence | Mitchell | lawrence_mitchell@zoho.com | Phoenix | Arizona | 85027 | \(928\) 782-5894 | Goldman Sachs |
| 4 | Maria | Garcia | m_garcia@hotmail.com | Denver | Colorado | 80277 | \(303\) 846-6634 | Evans Group |
| 5 | Michael | Hoffman | michael.hoffman@gmail.com | San Antonio | Texas | 78208 | \(214\) 901-0009 | Goodwin and Garrett |
| 96 | Daniel | Torres | daniel_torres@icloud.com | El Paso | Texas | 79944 | \(281\) 769-2210 | Henry Construction |
| 97 | Helen | Simpson | hsimpson20@yandex.com | El Paso | Texas | 79930 | \(210\) 345-8803 | Thompson Technologies |
| 98 | Mark | Graham | mark.graham65@mail.com | Charlotte | North Carolina | 28222 | \(336\) 732-4609 | Universal Consulting |
| 99 | Brian | Moore | bmoore95@zoho.com | Los Angeles | California | 90058 | \(707\) 702-7905 | Long Industries |
| 100 | Michael | Ward | michael_ward@yahoo.com | San Diego | California | 92147 | \(619\) 940-2614 | Pioneer Solutions |

``` python
# Standard set without city and state
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(exclude=["city", "state"])),
        n=100, seed=23,
    )
)
```

| PolarsRows100Columns5 |  |  |  |  |  |
|----|----|----|----|----|----|
|  | first_name *String* | last_name *String* | email *String* | postcode *String* | phone_number *String* |
| 1 | Weston | Parker | weston.parker23@gmail.com | 79404 | \(832\) 960-5399 |
| 2 | Hazel | Torres | hazel723@hotmail.com | 92873 | \(805\) 988-7427 |
| 3 | Lawrence | Mitchell | lawrence_mitchell@zoho.com | 85027 | \(928\) 782-5894 |
| 4 | Maria | Garcia | m_garcia@hotmail.com | 80277 | \(303\) 846-6634 |
| 5 | Michael | Hoffman | michael.hoffman@gmail.com | 78208 | \(214\) 901-0009 |
| 96 | Daniel | Torres | daniel_torres@icloud.com | 79944 | \(281\) 769-2210 |
| 97 | Helen | Simpson | hsimpson20@yandex.com | 79930 | \(210\) 345-8803 |
| 98 | Mark | Graham | mark.graham65@mail.com | 28222 | \(336\) 732-4609 |
| 99 | Brian | Moore | bmoore95@zoho.com | 90058 | \(707\) 702-7905 |
| 100 | Michael | Ward | michael_ward@yahoo.com | 92147 | \(619\) 940-2614 |

You can combine `include=` and `exclude=` in the same call, as long as the same preset does not appear in both.

## Column Prefixes

The `prefix=` parameter prepends a string to every column name. This is especially useful when a schema needs two independent profiles (e.g., sender and recipient):

``` python
schema = pb.Schema(
    **pb.profile_fields(set="minimal", prefix="sender_"),
    **pb.profile_fields(set="minimal", prefix="recipient_"),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23))
```

| PolarsRows100Columns8 |  |  |  |  |  |  |  |  |
|----|----|----|----|----|----|----|----|----|
|  | sender_first_name *String* | sender_last_name *String* | sender_email *String* | sender_phone_number *String* | recipient_first_name *String* | recipient_last_name *String* | recipient_email *String* | recipient_phone_number *String* |
| 1 | Weston | Parker | weston.parker23@gmail.com | \(214\) 673-2777 | Weston | Parker | weston.parker@outlook.com | \(915\) 827-6385 |
| 2 | Hazel | Torres | hazel723@hotmail.com | \(213\) 828-0231 | Hazel | Torres | hazeltorres@yandex.com | \(510\) 430-0382 |
| 3 | Lawrence | Mitchell | lawrence_mitchell@zoho.com | \(623\) 370-0982 | Lawrence | Mitchell | lmitchell@hotmail.com | \(480\) 609-6977 |
| 4 | Maria | Garcia | m_garcia@hotmail.com | \(970\) 694-0476 | Maria | Garcia | maria993@zoho.com | \(303\) 564-2441 |
| 5 | Michael | Hoffman | michael.hoffman@gmail.com | \(682\) 391-2143 | Michael | Hoffman | michael.hoffman84@gmail.com | \(940\) 486-1122 |
| 96 | Daniel | Torres | daniel_torres@icloud.com | \(915\) 504-6717 | Daniel | Torres | daniel.torres@gmail.com | \(832\) 313-0333 |
| 97 | Helen | Simpson | hsimpson20@yandex.com | \(940\) 869-0705 | Helen | Simpson | helensimpson@gmail.com | \(512\) 818-5803 |
| 98 | Mark | Graham | mark.graham65@mail.com | \(984\) 800-0885 | Mark | Graham | markgraham@gmail.com | \(984\) 656-7349 |
| 99 | Brian | Moore | bmoore95@zoho.com | \(650\) 955-2724 | Brian | Moore | bmoore93@yahoo.com | \(408\) 902-9175 |
| 100 | Michael | Ward | michael_ward@yahoo.com | \(949\) 771-2134 | Michael | Ward | michael.ward4@hotmail.com | \(650\) 916-0907 |

Each prefixed group maintains its own coherence: the sender's email is derived from the sender's name, and the recipient's email from the recipient's name.

## Combining with Other Field Types

Since [profile_fields()](../../reference/profile_fields.md#pointblank.profile_fields) returns a plain dictionary, it composes naturally with any other field types:

``` python
schema = pb.Schema(
    id=pb.int_field(unique=True, min_val=1000),
    **pb.profile_fields(),
    active=pb.bool_field(p_true=0.8),
    signup_date=pb.date_field(
        min_date="2024-01-01",
        max_date="2025-12-31",
    ),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23, country="DE"))
```

| PolarsRows100Columns10 |  |  |  |  |  |  |  |  |  |  |
|----|----|----|----|----|----|----|----|----|----|----|
|  | id *Int64* | first_name *String* | last_name *String* | email *String* | city *String* | state *String* | postcode *String* | phone_number *String* | active *Boolean* | signup_date *Date* |
| 1 | 7188536481533918196 | Agathe | Kramer | akramer@gmail.com | Potsdam | Brandenburg | 14820 | \(0335\) 989-6751 | False | 2024-10-23 |
| 2 | 2674009078779860983 | Rüdiger | Altmann | ruediger.altmann69@gmail.com | Halle (Saale) | Sachsen-Anhalt | 06210 | \(0345\) 239-7780 | False | 2024-03-26 |
| 3 | 7652102777077139150 | Bodo | Meyer | bodo723@web.de | Frankfurt am Main | Hessen | 60473 | \(0611\) 231-3262 | False | 2024-01-18 |
| 4 | 157503859921754048 | Stefanie | Meyer | stefanie_meyer@posteo.de | Leipzig | Sachsen | 04277 | \(0371\) 874-7863 | True | 2025-08-29 |
| 5 | 2829213282471976079 | Fabian | Thomas | f_thomas@web.de | Cologne | Nordrhein-Westfalen | 50708 | \(0203\) 870-5463 | True | 2024-11-10 |
| 96 | 7027508096731144830 | Maike | Fuchs | maike_fuchs@yahoo.de | Frankfurt am Main | Hessen | 60188 | \(0611\) 017-4531 | True | 2024-06-20 |
| 97 | 6055996548456657574 | Sebastian | König | sebastian_koenig@t-online.de | Augsburg | Bayern | 86110 | \(0841\) 916-6870 | True | 2025-04-05 |
| 98 | 3822709996092632587 | Diana | Henkel | dhenkel20@arcor.de | Frankfurt am Main | Hessen | 60198 | \(06151\) 561-5880 | False | 2024-02-04 |
| 99 | 1522653102058132294 | Matthias | Keßler | matthias.kessler65@outlook.de | Zwickau | Sachsen | 08826 | \(0351\) 850-7507 | False | 2024-02-27 |
| 100 | 5690877051669226498 | Dirk | Neumann | dneumann95@posteo.de | Nuremberg | Bayern | 90954 | \(0941\) 885-4226 | False | 2025-10-07 |