Window Identifiers

Most portals interact with the user by showing dialogs. These dialogs should generally be placed on top of the application window that triggered them. To arrange this, the compositor needs to know about the application window. Many portal requests expect a "parent_window" string argument for this reason.

Under X11, the "parent_window" argument should have the form x11:<XID>, where <XID> is the XID of the application window in hexadecimal notation. For example, x11:1234.

Under Wayland, it should have the form wayland:<HANDLE>, where <HANDLE> is a surface handle obtained with the xdg_foreign protocol. For example, wayland:~12l9jdl.-a.

For other windowing systems, or if you don’t have a suitable handle, just pass an empty string for "parent_window".