# FormatDisplayOptions

<!-- DO NOT EDIT: this page is autogenerated from the type comments -->

Defined in: [format.ts:263](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L263)

Options for formatting hotkeys for display.

## Properties

### keyLabels?

```ts
optional keyLabels?: Readonly<Record<string, string>>;
```

Defined in: [format.ts:281](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L281)

Final display overrides for logical keys or physical codes; take precedence over layoutMap. Never changes matching.

***

### layoutMap?

```ts
optional layoutMap?: object;
```

Defined in: [format.ts:279](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L279)

An already-resolved code-to-key map, such as KeyboardLayoutMap or Map.
Used only for physical bindings. Mapped keys receive normal display formatting;
missing or empty entries use conventional fallback labels. The caller owns
loading and refreshing the map; this formatter never calls browser APIs.

#### get

```ts
get: (code) => string | undefined;
```

##### Parameters

###### code

`string`

##### Returns

`string` \| `undefined`

***

### parts?

```ts
optional parts?: boolean;
```

Defined in: [format.ts:272](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L272)

Return individual key labels instead of a joined string. Default: false.

***

### platform?

```ts
optional platform?: "mac" | "windows" | "linux";
```

Defined in: [format.ts:268](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L268)

The target platform. Without it, `formatForDisplay` detects the platform
in the browser and uses `'linux'` on a server.

***

### separatorToken?

```ts
optional separatorToken?: string | null;
```

Defined in: [format.ts:283](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L283)

Override the separator between display tokens. Defaults to platform-specific formatting when null/undefined.

***

### sequenceSeparator?

```ts
optional sequenceSeparator?: string;
```

Defined in: [format.ts:285](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L285)

Separator between sequence steps. Default: a space.

***

### useSymbols?

```ts
optional useSymbols?: 
  | boolean
  | {
  keys?: boolean;
  modifiers?: boolean;
};
```

Defined in: [format.ts:270](https://github.com/TanStack/hotkeys/blob/main/packages/hotkeys/src/format.ts#L270)

Whether to use symbols for the display. Defaults to true.