Get started

While you create an account do the following:

  1. In the Address field, enter the matching URL of your store, such as Fill the other fields with necessary details.
  2. Select the Citrix Gateway authentication method, such as enabling the security token.
  3. Select the type of authentication, and then save the settings.
  4. When you use automatic configuration, do any of the following:

    • enter the FQDN of a StoreFront server or Citrix Gateway.
    • use an email address to create an account.
  5. When prompted, enter the user credentials before signing in.

For more information about configuring access to StoreFront through Citrix Gateway, see:

Configure and manage stores

Integrating StoreFront with Citrix Gateway

Google policy

Starting with Citrix Workspace app Version 1909 for Android, you can configure Citrix Workspace app from the Google Admin Console using the Google policy. This feature is supported on Chromebook devices only.

Using the Google policy, you can add one or more stores by adding the store URL.

Known issues:

  • This feature is not supported on Android Version 5.0 and earlier.
  • When you download the ICA file from a web browser and launch the session, the store added using the Google policy is not applied. Instead, Citrix Workspace app launches the downloaded ICA file.

Sample file of Google policy:

  "v1": {
    "stores": [
        "url": <">
        "url": <>


Provide the complete store URL and not only the name of the domain.

Email-based account discovery

You can configure Citrix Workspace app to use email-based account discovery. When configured, users enter their email address rather than a server URL during initial Citrix Workspace app for Android installation and configuration.

Citrix Workspace app for Android determines the Citrix Gateway or StoreFront server associated with the email address based on Domain Name System (DNS) Service (SRV) records. It then prompts the user to sign in, to access their hosted applications, desktops, and data.

Provision file

You can use StoreFront to create provisioning files that have connection details for accounts. You can make these files available to your users to enable them to configure Citrix Workspace app for Android automatically.

After installing Citrix Workspace app for Android, users simply open the .cr file on the device to configure Citrix Workspace app for Android. If you configure Workspace for websites, users can also get Citrix Workspace app for Android provisioning files from those sites.

For more information, see the StoreFront documentation.

Provide users with account information to enter manually

When you provide users with account details that they need to enter manually, make sure that you distribute the following information to enable them to connect to their hosted desktops successfully:

  • The StoreFront URL or XenApp and XenDesktop Site hosting resources; for example:

  • To access using Citrix Gateway, provide the Citrix Gateway address and required authentication method.

    See the Citrix Gateway documentation for more information.

When a user enters the details for a new account, Citrix Workspace app attempts to verify the connection. If successful, Citrix Workspace app prompts the user to log on to the account.

Provide access to Citrix Virtual Apps and Desktops and Citrix DaaS

Citrix Workspace app requires configuration of StoreFront to deliver apps, desktops, and files from your Citrix Virtual Apps and Desktops or Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) deployment.


You can configure StoreFront to provide authentication and resource delivery services for Citrix Workspace app, which enables you to create centralized enterprise stores to deliver:

  • Desktops and applications through Citrix Virtual Apps and Desktops or Citrix DaaS.
  • XenMobile Apps and mobile apps you have prepared for your organization through XenMobile.

Authentication between Citrix Workspace app and a StoreFront store can be handled using various solutions:

  • Users inside your firewall can connect directly to StoreFront.
  • Users outside your firewall can connect to StoreFront through Citrix Gateway.
  • Users outside your firewall can connect through Citrix Gateway to StoreFront.

Connecting to StoreFront

Citrix Workspace app for Android supports launching sessions from Workspace for Web, if the web browser works with Workspace for Web. If launches do not occur, configure your account through Citrix Workspace app for Android directly.


When Workspace for Web is used from a browser, sessions are not launched automatically when downloading an .ICA file. The .ICA file must be opened manually, right after it’s downloaded for the session to be launched.

With StoreFront, the stores you create consist of services that provide authentication and resource delivery infrastructure for Citrix Workspace app. Create stores that count and aggregate desktops and applications from XenDesktop sites and XenApp, making these resources available to users.

For administrators who need more control, Citrix provides a template you can use to create a download site for Citrix Workspace app for Android.

Configure stores for StoreFront just as you would Citrix Virtual Apps and Desktops and Citrix DaaS. No special configuration is needed for mobile devices.

Connect through Citrix Gateway

Citrix Workspace app for Android supports Citrix Gateway 11 and later with access to:

  • XenApp and XenDesktop Sites
  • StoreFront 2.6, 3.0, 3.5, 3.6, 3.7, 3.8, 3.9 and 3.11 stores

You can create multiple session policies on the same virtual server depending on the following:

  • the type of connection (such as ICA, clientless VPN, or VPN)
  • the type of Workspace deployment (Workspace for Web or locally installed Citrix Workspace app).

The policies can be achieved from a single virtual server.

When your users create accounts on Citrix Workspace app, they need to enter their email address or the matching FQDN of your Citrix Gateway server. For example, if the connection fails when using the default path, enter the full path to the Citrix Gateway server.

Citrix Endpoint Management

Workspace app enables users to access apps, files, and other resources delivered by Citrix Endpoint Management. For more information, see Integration with Citrix Workspace experience