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

# ComponentLayout

The object for defining the positioning for a specific component within the article’s column system.

```
object ComponentLayout
```

## Discussion

Use the `ComponentLayout` object to define a position for a specific component within the column system defined using the [`Layout`](/documentation/AppleNewsFormat/Layout) object.

For information on setting the units for the width and height, see <doc://com.apple.applenews/documentation/AppleNews/specifying-measurements-for-components>. For information on aligning components, see [`Anchor`](/documentation/AppleNewsFormat/Anchor).

> Note:
> If two components refer to the same `ComponentLayout` object, but they exist in containers of different column spans, both components adopt the width of the narrower component. This occurs even if the referenced `ComponentLayout` doesn’t explicitly declare `columnStart` or `columnSpan`. In this situation, use separate layouts for the child components.

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

### Example

```json
{
  "components": [
    {
      "role": "heading1",
      "layout": "heading1Layout",
      "text": "Heading Text"
    },
    {
      "role": "body",
      "text": "Apple News Format allows publishers to craft beautiful editorial layouts. Galleries, audio, video, and fun interactions like animation make stories spring to life."
    }
  ],
  "componentLayouts": {
    "heading1Layout": {
      "columnStart": 0,
      "columnSpan": 7,
      "margin": {
        "top": 24,
        "bottom": 10
      }
    }
  }
}
```

---

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)