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

# Layout

The object for defining columns, gutters, and margins for your article’s designed width.

```
object Layout
```

## Discussion

Use the `Layou`t object to define the column-system rules for the components in your document. The column system controls the horizontal position and spacing of your components. The News app uses this information to automatically resize your article for different screen sizes. Configuring your article with 20 columns, a 60-point margin, and a 20-point gutter should give you a sufficiently flexible layout.

After you define your article’s layout, add its components to [`ArticleDocument.componentLayouts`](/documentation/AppleNewsFormat/ArticleDocument/componentLayouts-data.dictionary) and then position each component using a [`ComponentLayout`](/documentation/AppleNewsFormat/ComponentLayout) object.

You can use object in [`ArticleDocument`](/documentation/AppleNewsFormat/ArticleDocument).

### Example

```json
{
  "version": "1.7",
  "identifier": "SampleArticle",
  "language": "en",
  "title": "Apple News",
  "layout": {
    "columns": 20,
    "width": 1024,
    "margin": 60,
    "gutter": 20
  },
  …
}
```

---

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)