---
title: "ExpandedSurfaceDescriptor, DroppyKit"
description: "Static description of one expanded surface, readable by the host without mounting anything."
canonical: "https://getdroppy.app/docs/droppykit/api/expanded-surface-descriptor"
last-updated: "2026-09-09"
---

# ExpandedSurfaceDescriptor

Static description of one expanded surface, readable by the host without mounting anything.

`struct ExpandedSurfaceDescriptor`

## Initializers

### init(id:title:systemImage:suppresses:)

`init(id: ExpandedSurfaceID, title: String, systemImage: String, suppresses: ExpandedSurfaceHostSuppression = .none)`

Creates a descriptor.

## Properties

### id

`let id: ExpandedSurfaceID`

Stable identifier, unique within the droplet.

### suppresses

`let suppresses: ExpandedSurfaceHostSuppression`

Which host behaviors stand down while this surface is presented.

### systemImage

`let systemImage: String`

SF Symbol name for those same surfaces.

### title

`let title: String`

User-visible title, sentence case. Used in the host's own logs, its settings copy, and anywhere it has to name what is holding the shelf.