# ABMultiValueInsert(_:_:_:_:_:) Inserts a value and its label at the given index in amulti-value list. ``` func ABMultiValueInsert(_ multiValue: ABMutableMultiValueRef!, _ value: CFTypeRef!, _ label: CFString!, _ index: CFIndex, _ outIdentifier: UnsafeMutablePointer?>!) -> Bool ``` ## Parameters `multiValue` The multi-value list you wish to modify. `value` An object representing a value in a multi-value list–it must be of the correct type. For example, if `multiValue` is the value for a property of type kABMultiStringProperty, then `value` needs to be a CFString object. See Property Types for a list of supported types in a multi-value list(see descriptions of the `kABMulti...` constants). If `value` is `NULL`, this function raises an exception. `label` The label for `value`—it need not be unique. If `label` is `NULL`, this function raises an exception. `index` The index to insert `value` at. If `index` is out of bounds, this function raises an exception. `outIdentifier` If `value` is added successfully, this parameter returns the new identifier. ## Return Value `true` ifsuccessfully, `false` otherwise. ## Discussion This function performs no type checking and will let you adda value whose type does not match the types of the other valuesin the list. However, if you try to use a multi-value list whosevalues are not all of the same type, functions, such as the ABRecord [`ABRecordSetValue(_:_:_:_:)`](/documentation/AddressBook/ABRecordSetValue(_:_:_:_:)) function,will returns `NULL` or kABErrorProperty. --- Copyright © 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)