# DisplayOptions

## class DisplayOptions( style: Literal['html', 'text'] = 'html', timezone: str = 'UTC', time_format: Literal['iso', 'readable'] = 'iso', time_precision: Literal['s', 'ms', 'us', 'ns'] = 's', show_link: bool = True, collapse_threshold: int = 10, max_items: int = 50, )[source]

Bases: [`object`](https://docs.python.org/3/builtins/functions.html#object "(in Python v3.15)")

How instruments and publishers display in notebooks.

Change these with [`set_display_options`](https://dev.nominal.io/instro/ref/library/instro.lib.set_display_options.md#instro.lib.set_display_options "instro.lib.set_display_options"), and read the current values with [`get_display_options`](https://dev.nominal.io/instro/ref/library/instro.lib.get_display_options.md#instro.lib.get_display_options "instro.lib.get_display_options").

### style: Literal['html', 'text'] = 'html'

`"html"` shows objects as formatted cards. `"text"` shows their plain `repr`.

### timezone: str = 'UTC'

`"UTC"`, `"local"` for the notebook kernel’s time zone, or an IANA name such as
`"Europe/Berlin"`.

Type:
:   Time zone for timestamps

### time_format: Literal['iso', 'readable'] = 'iso'

`"iso"` shows timestamps as ISO 8601, such as `2026-11-02T16:33:03Z`. `"readable"` uses a space and
the time zone’s name, such as `2026-11-02 16:33:03 UTC`.

### time_precision: Literal['s', 'ms', 'us', 'ns'] = 's'

`"s"`, `"ms"`, `"us"` or `"ns"`. Finer digits are cut off, not
rounded, and trailing zeros are left out, so `"ns"` shows each timestamp exactly.

Type:
:   The finest unit timestamps show

### show_link: bool = True

Whether cards link datasets to their pages in the Nominal app.

Building a link resolves the client’s workspace. The first card for a client that hasn’t resolved it yet makes
one request; later cards reuse the result.

### collapse_threshold: int = 10

Sections with more items than this, such as channels, start collapsed.

### max_items: int = 50

The most items a section lists. The section says how many more were left out.