<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/ListFormatter",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "c:objc(cs)NSListFormatter"
  },
  "title" : "ListFormatter"
}
-->

# ListFormatter

An object that provides locale-correct formatting of a list of items using the appropriate separator and conjunction.

```
class ListFormatter
```

## Overview

The list formatter isn’t aware of the context where the formatted string will be used and doesn’t provide capitalization customization of the list items. The formatted result may not be grammatically correct if placed in a sentence, and it should only be used in a standalone manner.

## Topics

### Converting Arrays to Formatted Lists

[`string(from:)`](/documentation/Foundation/ListFormatter/string(from:))

Creates a formatted string for an array of items.

[`string(for:)`](/documentation/Foundation/ListFormatter/string(for:))

Creates a formatted string for an array of items.

[`localizedString(byJoining:)`](/documentation/Foundation/ListFormatter/localizedString(byJoining:))

Constructs a formatted string from an array of strings that uses the list format specific to the current locale.

### Configuring Formatter Options

[`itemFormatter`](/documentation/Foundation/ListFormatter/itemFormatter)

An object that formats each item in the list.

[`locale`](/documentation/Foundation/ListFormatter/locale)

The locale to use when formatting items in the list.


---

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)