# TerminalOptions Properties

- Package: [Aspire.Hosting](/reference/api/csharp/aspire.hosting.md)
- Type: [TerminalOptions](/reference/api/csharp/aspire.hosting/terminaloptions.md)
- Kind: `Properties`
- Members: `3`

Options for configuring a terminal session.

<a id="columns"></a>

## Columns

- Name: `Columns`
- Modifiers: `get; set`
- Returns: `int`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/b5f143315ffb6968ea939a9978797a5b20e4c688/src/Aspire.Hosting/ApplicationModel/TerminalAnnotation.cs)

Gets or sets the initial number of columns for the terminal. The value must be greater than zero. Defaults to 120.

```csharp
public int Columns { get; set; }
```

## Exceptions

- `ArgumentOutOfRangeException` -- Thrown when set to zero or a negative value.

<a id="rows"></a>

## Rows

- Name: `Rows`
- Modifiers: `get; set`
- Returns: `int`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/b5f143315ffb6968ea939a9978797a5b20e4c688/src/Aspire.Hosting/ApplicationModel/TerminalAnnotation.cs)

Gets or sets the initial number of rows for the terminal. The value must be greater than zero. Defaults to 30.

```csharp
public int Rows { get; set; }
```

## Exceptions

- `ArgumentOutOfRangeException` -- Thrown when set to zero or a negative value.

<a id="showterminalhost"></a>

## ShowTerminalHost

- Name: `ShowTerminalHost`
- Modifiers: `get; set`
- Returns: `bool`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/b5f143315ffb6968ea939a9978797a5b20e4c688/src/Aspire.Hosting/ApplicationModel/TerminalAnnotation.cs)

Gets or sets a value indicating whether the per-replica terminal host resources (named `{parent}-terminalhost-{index}`) should appear in the resource list.

```csharp
public bool ShowTerminalHost { get; set; }
```

## Remarks

Defaults to `false`: terminal host resources are hidden from the dashboard and CLI resource list because they are an implementation detail of the [TerminalResourceBuilderExtensions.WithTerminal(IResourceBuilder<T>, Action<TerminalOptions>)](/reference/api/csharp/aspire.hosting/terminalresourcebuilderextensions/methods.md#withterminal-iresourcebuilder-t-action-terminaloptions) feature, not something the user explicitly added to their app model.

Set to `true` when diagnosing terminal-host startup / connectivity issues so the host's state, exit code, logs, and (eventually) telemetry are visible alongside the parent resource. This is useful when investigating cases like "DCP never dialed the producer UDS" or "the host crashed during recycle".