---
title: "ShelfWidgetPlacement, DroppyKit"
description: "A widget's horizontal position within its shelf row."
canonical: "https://getdroppy.app/docs/droppykit/api/shelf-widget-placement"
last-updated: "2026-09-09"
---

# ShelfWidgetPlacement

A widget's horizontal position within its shelf row.

`enum ShelfWidgetPlacement`

This is deliberately separate from [`isPaired`](https://getdroppy.app/docs/droppykit/api/shelf-widget-context#is-paired). A three-or-four-card row has both leading and trailing peers around a middle card, whose content must center rather than pretending it owns either edge. The host owns row layout; a product only receives this stable, presentation-neutral placement fact.

## Cases

### ShelfWidgetPlacement.solo

`case solo`

### ShelfWidgetPlacement.leading

`case leading`

### ShelfWidgetPlacement.trailing

`case trailing`

### ShelfWidgetPlacement.middle

`case middle`

## Initializers

### init(rawValue:)

`init?(rawValue: String)`

## Properties

### isPaired

`var isPaired: Bool { get }`

Whether the widget shares its row with any other widget. The compatibility name "paired" includes two-to-four-widget rows.