<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AddressBook",
  "identifier" : "/documentation/AddressBook/ABGroupSetDistributionIdentifier(_:_:_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Address Book"
    ],
    "preciseIdentifier" : "c:@F@ABGroupSetDistributionIdentifier"
  },
  "title" : "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).

```
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

`true` ifsuccessful, `false` otherwise.

## 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.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)