---
title: "ABGroupSetDistributionIdentifier(_:_:_:_:)"
framework: addressbook
role: symbol
role_heading: Function
path: "addressbook/abgroupsetdistributionidentifier(_:_:_:_:)"
---

# ABGroupSetDistributionIdentifier(_:_:_:_:)

Assigning a specific distribution identifier for a person’smulti-value list property so that the group can be used as a distributionlist (mailing list, in the case of an email property).

## Declaration

```swift
func ABGroupSetDistributionIdentifier(_ group: ABGroupRef!, _ person: ABPersonRef!, _ property: CFString!, _ identifier: CFString!) -> Bool
```

## Parameters

- `group`: The group that person belongs to.
- `person`: The person whose distribution identifier for property you wish to change. If NULL, this function raises an exception.
- `property`: The multi-value list property whose distribution identifier you wish to change.
- `identifier`: The new distribution identifier, a label used by a multi-value list such as kABAddressHomeLabel for a kABAddressProperty. Pass NULL to reset the distribution identifier to its default, a multi-value list’s primary identifier.

## Return Value

Return Value true ifsuccessful, false otherwise.

## Discussion

Discussion The default distribution identifier is a multi-value list’sprimary identifier. Use this function if you need to change thedistribution identifier for a particular person. For example, ifthe default identifier is a person’s home email but you want touse John’s work email, invoke this function passing kABEmailWorkLabel asthe identifier parameter, kABEmailProperty asthe property parameter, and John’sperson object as the person parameter.

## See Also

### Groups

- [ABCopyArrayOfAllGroups(_:)](addressbook/abcopyarrayofallgroups(_:).md)
- [ABGroupAddGroup(_:_:)](addressbook/abgroupaddgroup(_:_:).md)
- [ABGroupAddMember(_:_:_:)](addressbook/abgroupaddmember(_:_:).md)
- [ABGroupCopyArrayOfAllMembers(_:)](addressbook/abgroupcopyarrayofallmembers(_:).md)
- [ABGroupCopyArrayOfAllSubgroups(_:)](addressbook/abgroupcopyarrayofallsubgroups(_:).md)
- [ABGroupCopyDistributionIdentifier(_:_:_:)](addressbook/abgroupcopydistributionidentifier(_:_:_:).md)
- [ABGroupCopyParentGroups(_:)](addressbook/abgroupcopyparentgroups(_:).md)
- [ABGroupCreate()](addressbook/abgroupcreate().md)
- [ABGroupCreateSearchElement(_:_:_:_:_:)](addressbook/abgroupcreatesearchelement(_:_:_:_:_:).md)
- [ABGroupRemoveGroup(_:_:)](addressbook/abgroupremovegroup(_:_:).md)
- [ABGroupRemoveMember(_:_:_:)](addressbook/abgroupremovemember(_:_:).md)