# PopupOptions

**Kind**: interface | **Module**: [Windows](https://docs.interop.io/desktop/reference/javascript/windows/index.md)

**Source**: https://docs.interop.io/desktop/reference/javascript/windows/popupoptions/index.html

Options for creating popup windows.

## Properties

- **`focus`** (`boolean`, optional) default: `true` *(since io.Connect Desktop 10.0, @interopio/desktop 6.16.0)*
  If `true`, the popup window will gain focus when shown and will hide automatically when it loses focus. If `false`, the popup window won't be on focus when shown and won't hide automatically if it gains and loses focus afterwards. If you set this to `false`, you will be responsible for implementing the conditions and the mechanism for hiding/closing the popup window.
- **`horizontalOffset`** (`number`, optional)
  Horizontal offset from the target bounds (applied only to `left` and `right` target locations).
- **`size`** (`Size`, required)
  Size of the rendered popup window.
- **`targetBounds`** (`Bounds`, required)
  Bounds of the area around which the popup will appear.
- **`targetLocation`** (`PopupTargetLocation`, required)
  Location (`"bottom"`, `"top"`, `"left"`, `"right"` or `"none"`) where the popup will appear, relative to the defined popup area.
  If `"none"` is passed, the popup will appear at `{ left: 0, top: 0 }` of the popup area.
- **`verticalOffset`** (`number`, optional)
  Vertical offset from the target bounds (applied only to `top` and `bottom` target locations).
- **`windowId`** (`string`, required)
  ID of the window which will be used as a popup window.
  As of **io.Connect Desktop** 10.0, the popup window must be a frameless window.

## Related types

- [Bounds](https://docs.interop.io/desktop/reference/javascript/windows/bounds/index.md)
- [PopupTargetLocation](https://docs.interop.io/desktop/reference/javascript/windows/popuptargetlocation/index.md)
- [Size](https://docs.interop.io/desktop/reference/javascript/windows/size/index.md)