Name Storage for Single Names
Depending on the requirements and cultural appropriateness, you can store a single name in your system using one of the following approaches:-
GivenNameField (Preferred)- Store the single name in the
GivenNamefield to reflect it as the primary identifying name for the applicant. - This approach provides the most straightforward and intuitive handling for systems where a single name is supported.
- Store the single name in the
-
FamilyNameField- Alternatively, store the single name in the
FamilyNamefield if this aligns better with cultural or regulatory practices. - Ensure that any system rules that differentiate between given and family names are appropriately configured to accept a single name in this context.
- Alternatively, store the single name in the
-
DisplayNamefor Renderings- Utilize the
DisplayNamefield to reflect culturally appropriate renderings of the name. This is particularly important for systems that output names for display where a single name might be used differently than conventional given-family name structures.
- Utilize the
Special Cases: Australian Document Verification Service (DVS)
- Use a hyphen (
-) as the first name placeholder. - Enter the single name into the
FamilyNamefield. - A full stop (
.) can be used as an alternative to a hyphen if preferred by the service providers during verification processes.
Tips for Implementation
- Consistent Application: Ensure your application’s data entry and storage processes consistently apply these rules to prevent errors or discrepancies in user data.
- Choose Appropriate Fields: Select the field that best suits both your internal requirements and the cultural context of the applicant.
- Configured Displays: Adjust how names are displayed in your application. Use
DisplayNamefor areas where users or clients view a person’s name, ensuring natural or preferred readings.
For detailed technical specifications, please refer to our API Reference which includes full descriptions and examples for the
PersonalNameObject.