WorkSpaces Android client application - Amazon WorkSpaces
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

WorkSpaces Android client application

The following information will help you get started with the WorkSpaces Android client application.


The Amazon WorkSpaces Android client application requires the following:

  • Amazon Kindle Fire tablets released after 2012 with Fire OS 4.0 and later.

  • Android tablets and phones with Android OS 4.4 and later. The client application works on most devices with Android version 4.4 or later, but some devices might not be compatible. If you have problems with a device, you can report the problem on the WorkSpaces forum.


    Versions of the Android client application after 2.4.15 require devices with Android OS 9 and later.

    Versions of the Android client application after 5.0.0 require devices with Android OS 13 and later.

  • Devices that support running 64-bit applications.

  • The WorkSpaces Android client application is not available for the WorkSpaces Streaming Protocol (WSP).

  • If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 2.4.19 or later of the Amazon WorkSpaces Android client application.

Setup and installation

To download and install the client application, complete the following procedure.

To download and install the client application
  1. On your Android device, open and choose the Android link.

  2. Download and install the application.

  3. Verify that the Amazon WorkSpaces client application icon appears on one of the device desktops.

Connect to your WorkSpace

To connect to your WorkSpace, complete the following procedure.

To connect to your WorkSpace
  1. On your device, open the Amazon WorkSpaces client application.

  2. The first time that you run the client application, you are prompted for your registration code, which is contained in your welcome email. The WorkSpaces client application uses the registration code and user name to identify which WorkSpace to connect to. When you launch the client application later, the same registration code is used. You can enter a different registration code by launching the client application and tapping Enter new registration code on the login screen.

  3. Enter your sign-in credentials and tap Sign In. If your WorkSpaces administrator has enabled multi-factor authentication for your organization's WorkSpaces, you are prompted for a passcode to complete your login. Your WorkSpaces administrator will provide more information about how to obtain your passcode.

  4. If your WorkSpaces administrator has not disabled the "Remember Me" feature, you are prompted to save your credentials securely so that you can connect to your WorkSpace easily in the future. Your credentials will be securely cached up to the maximum lifetime of your Kerberos ticket.

    After the client application connects to your WorkSpace, your WorkSpace desktop is displayed.


The following gestures are supported for the WorkSpaces Android client application.

Single tap

Equivalent to a single click in Windows.

Double tap

Equivalent to a double-click in Windows.

Two finger single tap

Equivalent to a right-click in Windows.

Two finger double tap

Toggles the on-screen keyboard display. If a keyboard is attached to the device, a set of keyboard shortcuts is shown instead.

Swipe from left

Displays the sidebar menu. For more information, see Sidebar menu.

Two finger scroll

Scrolls vertically.

Two finger pinch

Zooms display in or out.

Two finger pan

Pans the desktop when zoomed in.

Sidebar menu

The sidebar menu is displayed by swiping from the left side of the screen.

Android sidebar menu

The sidebar menu provides quick access to the following features:

Trackpad Mode – Turns the trackpad on or off. For more information, see Trackpad mode.

Show Keyboard – Toggles the display of the on-screen keyboard. If a keyboard is already attached, only a row of keyboard shortcuts is displayed.

Settings – Displays controls to change the screen resolution or the scroll direction.

Connection Check – Displays the connection status.

Windows Menu – Displays the Windows Start Menu.

Disconnect – Disconnects the client application without logging off.


To toggle the display of the on-screen keyboard, double-tap with two fingers anywhere on the screen. Special key combinations are displayed in the top row of the keyboard.

Trackpad mode

The trackpad mode is set using the sidebar menu.

Trackpad mode off

When trackpad mode is off, the mouse cursor is placed wherever you tap your finger. In this mode, a single tap is equivalent to a left mouse button click and a two finger single tap is equivalent to a right mouse button click.

Trackpad mode on

When trackpad mode is on, the mouse cursor tracks the movement of your finger on the screen. In this mode, simulate a left mouse button click by tapping the left mouse button icon.

Left mouse button icon

Simulate a right mouse button click by tapping the right mouse button icon.

Right mouse button icon

Display support

The Amazon WorkSpaces Android client application supports a single monitor. Multiple monitors are not supported.

The maximum supported screen resolution depends on your device's display. Although specific screen resolution settings are offered in the Settings menu, if you choose Default, WorkSpaces matches the resolution that you've set on your device. If your device supports a resolution higher than 2800x1752, choose Default if you want WorkSpaces to use a higher resolution.

Resolution setting When to use
2800x1752, 2560x1440, 1920x1080, 1600x900, 1280x720, 960x540 Choose one of these settings if you want your display to use this exact resolution.
Default Choose this setting to match the resolution that you've set on your device, up to the maximum resolution that your device supports. If you choose Default and you're using a high DPI display, the screen resolution is adjusted to a lower one so that text and icons are easier to read.
High DPI Mode Choose this setting for better maximum resolution of your WorkSpace on high DPI displays. If you choose High DPI Mode and the text and icons on your WorkSpace are smaller than you'd prefer, either choose Default instead, or adjust the scaling settings on your WorkSpace. For more information about high DPI mode and how to adjust the scaling settings on your WorkSpace, see WorkSpaces high DPI display support.


To disconnect the Android client, display the sidebar menu, tap the disconnect icon, and tap Disconnect. You can also log off of the WorkSpace, which disconnects the client.

Clipboard support

The clipboard supports copy and paste of text and HTML content only. The maximum uncompressed object size is 20 MB. For more information, see I'm having trouble copying and pasting.


When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds.

Release notes

The following table describes the changes to each release of the Android client application.

Release Date Changes


February 26, 2024
  • Added support for the Israel (Tel Aviv) Region..

  • Updated PCoIP SDK for Android.

  • Added accessibility improvements, including screen reader support and keyboard-only navigation enhancement.


August 18, 2023
  • Improved client custom branding by storing assets in the same Amazon Regions as provisioned WorkSpaces.

  • Resolved the Spanish keyboard mapping issues.


May 5, 2023
  • Added connection support to WorkSpaces provisioned in the Amazon GovCloud (US-East) Region

  • Added accessibility enhancements


December 15, 2022

Updated the .NET framework for the WorkSpaces Android client


October 20, 2022

Upgraded target Android API level to continue supporting 64-bit Android 12 and later versions


August 3, 2022

Resolved an issue that the touchpad scrolling was too sensitive within WorkSpaces on Chromebooks


May 12, 2022
  • Updated PCoIP SDK for the WorkSpaces Android client

  • Updated WSP SDK for the WorkSpaces Android client


October 14, 2021
  • Resolves crashing issues related to invalid cursor data

  • Bug fixes

3.0.2 July 13, 2021

Minor enhancements and fixes

3.0.1 June 30, 2021
  • Adds support for self-service WorkSpace management capabilities.

  • Adds support for certificate-based trusted devices.

2.4.21 May 20, 2021
  • Adds 2800x1752 and High DPI Mode in resolution options

  • Addresses a crash scenario related to cursor rendering

  • Minor enhancements and fixes


Because the 32-bit PCoIP SDK for Android has reached the end of support, Version 2.4.21 is the final release of Amazon WorkSpaces Android client, which supports both 32-bit and 64-bit for Android 9 and above. Next release onwards, Amazon WorkSpaces Android client will only support 64-bit.


March 25, 2021
  • Addresses a crash issue at login

  • Minor enhancements and fixes


February 22, 2021

Enhanced support for resolution 2560x1440


October 19, 2020
  • Adds support for certain Chromebook models that were previously not supported

  • Fixes multiple key-mapping issues pertaining to English, French, and Japanese keyboard layouts

  • Adds support for faster reconnection to WorkSpaces on Chromebook devices when resuming from sleep mode


February 24, 2020

Minor enhancements and fixes


January 30, 2020

Added support for versions above 64-bit Android 9


June 24, 2019
  • Adds support for mouse cursor contextual shape changes

  • This is the last version that supports versions below Android 8


  • Adds support for the Right alt key mapping with Japanese keyboard layouts

  • Resolves an occasional issue with blue overlay


Minor fixes


  • Resolves an issue that makes the login page bounce on a few devices

  • Minor fixes


  • Resolves an issue with content being selected with two-finger scrolling

  • Minor fixes


Improves support for Japanese keyboard layouts


Adds support for Samsung Galaxy Note 9


  • Improves clipboard redirection

  • Improves DeX startup


Adds support for uniform resource identifiers (URIs), which enable login orchestration


  • Adds support for time zone redirection for more Regions: America/Indianapolis America/Indiana/Marengo America/Indiana/Vevay America/Indiana/Indianapolis

  • Includes text changes to the Login page user interface


Minor improvements to session provision handling


  • Minor fixes

  • Improves copy and paste


  • New logo

  • Improves the user interface and stability


  • Addresses a display overlay issue on Android Oreo when a mouse is connected to the device

  • Adds support for Samsung S8/S8+ screen configurations

  • Resolves minor issues


Localization enhancements


  • Adds support for the German language

  • Improves the Japanese user interface

  • Improves stability


  • Adds support for the following new WorkSpace states: STOPPING and STOPPED

  • Adds support for audio in, enabling you to make calls or attend web conferences

  • Resolves minor issues and improves stability


  • Adds support for saving registration codes, enabling you to switch WorkSpaces without re-entering the registration codes

  • Improves usability and stability


  • Adds advanced connection health checks, enabling you to troubleshoot connection issues

  • Improves stability


  • Improves the user interface and login experience

  • Adds support for choosing the screen resolution

  • Adds support for choosing the scrolling direction


  • Improves the login experience

  • Adds time zone synchronization between the local device and the WorkSpace


Improves the login experience


Initial release