---
title: "init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:relationship:)"
framework: intents
role: symbol
role_heading: Initializer
path: "intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:relationship:)"
---

# init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:relationship:)

Creates a person with the specified name, contact, and relationship information.

## Declaration

```swift
convenience init(personHandle: INPersonHandle, nameComponents: PersonNameComponents?, displayName: String?, image: INImage?, contactIdentifier: String?, customIdentifier: String?, relationship: INPersonRelationship?)
```

## Parameters

- `personHandle`: A string that contains information your app uses to identify the user. You can create a person handle from an email address, phone number, or account name associated with the user.
- `nameComponents`: The name of the user, specified as a set of name components.
- `displayName`: The string you display for the user’s name.
- `image`: An image of the person.
- `contactIdentifier`: The identifier associated with the user’s doc://com.apple.documentation/documentation/Contacts/CNContact object. Specify a value for this parameter when the user has a corresponding entry in the Contacts database.
- `customIdentifier`: A custom string that you use to identify people in your app.
- `relationship`: The relationship of this person to the current user.

## Return Value

Return Value An initialized person object or nil if initialization fails.

## Discussion

Discussion Use this method when creating person objects you plan to return as part of a response to Siri. Specify as much information as possible about the user. This method makes copies of the parameters instead of keeping the originals.

## See Also

### Creating a person

- [init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:)](intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:).md)
- [init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:isMe:)](intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:isme:).md)
- [init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:isMe:suggestionType:)](intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:isme:suggestiontype:).md)
- [init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:aliases:suggestionType:)](intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:aliases:suggestiontype:).md)
- [init(personHandle:nameComponents:displayName:image:contactIdentifier:customIdentifier:isContactSuggestion:suggestionType:)](intents/inperson/init(personhandle:namecomponents:displayname:image:contactidentifier:customidentifier:iscontactsuggestion:suggestiontype:).md)