diff --git a/.github/ISSUE_TEMPLATE/testplan.md b/.github/ISSUE_TEMPLATE/testplan.md
index e3d3e0d75c718..7f7d4d1abe675 100644
--- a/.github/ISSUE_TEMPLATE/testplan.md
+++ b/.github/ISSUE_TEMPLATE/testplan.md
@@ -1238,7 +1238,7 @@ tsh bench web sessions --max=5000 --web user ls
- [ ] A folder from inside the shared directory can be copy-pasted to another folder inside shared directory (and its contents retained)
- RBAC
- [ ] Give the user one role that explicitly disables directory sharing (`desktop_directory_sharing: false`) and confirm that the option to share a directory doesn't appear in the menu
-- Per-Session MFA (try webauthn on each of Chrome, Safari, and Firefox; u2f only works with Firefox)
+- Per-Session MFA
- [ ] Attempting to start a session no keys registered shows an error message
- [ ] Attempting to start a session with a webauthn registered pops up the "Verify Your Identity" dialog
- [ ] Hitting "Cancel" shows an error message
@@ -1282,6 +1282,10 @@ tsh bench web sessions --max=5000 --web user ls
- Set up Teleport in a trusted cluster configuration where the root and leaf cluster has a w_d_s connected via tunnel (w_d_s running as a separate process)
- [ ] Confirm that windows desktop sessions can be made on root cluster
- [ ] Confirm that windows desktop sessions can be made on leaf cluster
+- Screen size
+ - [ ] Desktops that specify a fixed `screen_size` in their spec always use the same screen size.
+ - [ ] Desktops sessions for desktops which specify a fixed `screen_size` do not resize automatically.
+ - [ ] Attempting to register a desktop with a `screen_size` dimension larger than 8192 fails.
- Non-AD setup
- [ ] Installer in GUI mode finishes successfully on instance that is not part of domain
- [ ] Installer works correctly invoked from command line
@@ -1412,7 +1416,7 @@ TODO(lxea): replace links with actual docs once merged
## SSH Connection Resumption
-Verify that SSH works, and that resumable SSH is not interrupted across a Teleport Cloud tenant upgrade.
+Verify that SSH works, and that resumable SSH is not interrupted across a Teleport Cloud tenant upgrade.
| | Standard node | Non-resuming node | Peered node | Agentless node |
|---|---|---|---|---|
| `tsh ssh` |
| | | |
diff --git a/docs/pages/desktop-access/reference/configuration.mdx b/docs/pages/desktop-access/reference/configuration.mdx
index ed148288da5e9..589248bf34404 100644
--- a/docs/pages/desktop-access/reference/configuration.mdx
+++ b/docs/pages/desktop-access/reference/configuration.mdx
@@ -43,3 +43,26 @@ desktop sessions are performed over this tunnel. To enable this mode, ensure
that `windows_desktop_service.listen_addr` is *unset*, and point
`teleport.proxy_server` at a Teleport Proxy.
+## Screen size
+
+By default, Teleport will set the screen size of the remote desktop session
+based on the size of your browser window. In some cases, you may wish to
+configure specific hosts to use a specific screen size. To do this, set the
+`screen_size` attribute on the `windows_desktop_resource`:
+
+```yaml
+kind: windows_desktop
+metadata:
+ name: fixed-screen-size
+spec:
+ host_id: 307e091b-7f6b-42e0-b78d-3362ad10b55d
+ addr: 192.168.1.153:3389
+ non_ad: true
+
+ # Optional - ensures that all sessions use the same screen size,
+ # no matter what the size of the browser window is.
+ # Leave blank to use the size of the browser window.
+ screen_size:
+ width: 1024
+ height: 768
+```
\ No newline at end of file
diff --git a/docs/pages/reference/resources.mdx b/docs/pages/reference/resources.mdx
index b4be31487fbfc..248d774601869 100644
--- a/docs/pages/reference/resources.mdx
+++ b/docs/pages/reference/resources.mdx
@@ -154,7 +154,7 @@ desktops this way:
connections to the host. If you have multiple such services, you can create
multiple `windows_desktop` resources with different `host_id` values.
1. If you intend to log in to the desktop with local Windows users you must set
- `non_ad: true`. If you intent to log in with Active Directory users, leave
+ `non_ad: true`. If you intend to log in with Active Directory users, leave
`non_ad` unset (or false), and specify the Active Directory domain in the
`domain` field.
@@ -170,6 +170,13 @@ spec:
addr: 192.168.1.153:3389
domain: ""
non_ad: true
+
+ # Optional - ensures that all sessions use the same screen size,
+ # no matter what the size of the browser window is.
+ # Leave blank to use the size of the browser window.
+ screen_size:
+ width: 1024
+ height: 768
version: v3
```