Module to generate people's personal information such as names and job titles.Overview
To generate a full name, use {{$person.fullName}}. Note that this is not the same as simply concatenating {{$person.firstName}} and {{$person.lastName}}, as the full name may contain a prefix, suffix, or both. Additionally, different supported locales will have differing name patterns. For example, the last name may appear before the first name, or there may be a double or hyphenated first or last name.You can also generate the parts of a name separately, using {{$person.prefix}}, {{$person.firstName}}, {{$person.middleName}}, {{$person.lastName}}, and {{$person.suffix}}. Not all locales support all of these parts.Many of the methods in this module can optionally choose either female, male or mixed names.Job-related data is also available. To generate a job title, use {{$person.jobTitle}}.This module can also generate other personal information which might appear in user profiles, such as {{$person.gender}}, {{$person.zodiacSign}}, and {{$person.bio}}.Related modules
For personal contact information like phone numbers and email addresses, see the Phone and Internet modules.
bio#
Returns a random short biography
firstName#
Returns a random first name.| Name | Type | Default | Description |
|---|
| sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male'. |
fullName#
Generates a random full name.| Name | Type | Default | Description |
|---|
| firstName | string | {{$person.firstName}} | The optional first name to use. If not specified a random one will be chosen. |
| lastName | string | {{$person.lastName}} | The optional last name to use. If not specified a random one will be chosen. |
| sex | 'female' | 'male' | {{$helpers.arrayElement(['female','male'])}} | The optional sex to use. Can be either 'female' or 'male'. |
gender#
jobArea#
Generates a random job area.
jobDescriptor#
Generates a random job descriptor.
jobTitle#
Generates a random job title.
lastName#
Returns a random last name.| Name | Type | Default | Description |
|---|
| sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male'. |
middleName#
Returns a random middle name.| Name | Type | Default | Description |
|---|
| sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male'. |
prefix#
Returns a random person prefix.| Name | Type | Default | Description |
|---|
| sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male'. |
sex#
Output of this method is localised, so it should not be used to fill the parameter sex available in some other modules for example {{$person.firstName}}.
sexType#
Returns a random sex type. The SexType is intended to be used in parameters and conditions.Returns: 'female' | 'male'
suffix#
Returns a random person suffix.
zodiacSign#
Returns a random zodiac sign.
Modified at 2025-06-25 07:57:16
