<!--
{
  "availability" : [
    "Apple News Format: 1.9.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppleNewsFormat",
  "identifier" : "/documentation/AppleNewsFormat/HorizontalStackDisplay",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple News Format"
    ],
    "preciseIdentifier" : "data:news_format:HorizontalStackDisplay"
  },
  "title" : "HorizontalStackDisplay"
}
-->

# HorizontalStackDisplay

The object for displaying components side by side in a Container component.

```
object HorizontalStackDisplay
```

## Discussion

Use the `HorizontalStackDisplay` object in a container component for displaying components side by side.

Use `HorizontalStackDisplay` if you wish to specify what percent of the width the individual children should use. Use [`CollectionDisplay`](/documentation/AppleNewsFormat/CollectionDisplay) if you wish to make all child components to have the same width.

To redistribute the empty space inside a horizontal stack collection, use the [`FlexibleSpacer`](/documentation/AppleNewsFormat/FlexibleSpacer) object.

> Note:
> In versions of iOS before iOS 12, child components are vertically stacked if the container’s `contentDisplay` property is defined as the new `horizontal_stack` type.

This object can be used in [`Header`](/documentation/AppleNewsFormat/Header), [`Container`](/documentation/AppleNewsFormat/Container), [`Section`](/documentation/AppleNewsFormat/Section), [`Chapter`](/documentation/AppleNewsFormat/Chapter), [`Aside`](/documentation/AppleNewsFormat/Aside), and [`ArticleLink`](/documentation/AppleNewsFormat/ArticleLink).

### Example

```json
{
  "components": [
    {
      "role": "container",
      "contentDisplay": {
        "type": "horizontal_stack"
      },
      "components": [
        {
          "role": "title",
          "text": "Sample article",
          "layout": {
            "minimumWidth": "60cw",
            "maximumWidth": "60cw"
          }
        },
        {
          "role": "spacer"
        },
        {
          "role": "image",
          "URL": "bundle://image-1.jpg",
          "layout": {
            "minimumWidth": "35cw",
            "maximumWidth": "35cw"
          }
        }
      ]
    }
  ]
}
```

---

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)