Configure settings for cloud stores


You can configure Citrix Workspace app settings for cloud stores using the Global App Configuration service (GACS). It helps admins configure and manage Citrix Workspace app for end users on both managed and unmanaged devices. This service is supported on Windows, Mac, Android, iOS, HTML5, and ChromeOS platforms.


  • The addresses <>, <>, and <> must be contactable. It’s required for the functioning of email-based discovery and Global App Configuration services.

  • Verify that you have access to a Citrix Cloud account. If not, you can create an account from For more information, refer to Sign up for Citrix Cloud.

  • Verify that you have a Workspace subscription.

Get started with configuration

You can sign in to your Citrix Cloud account and configure settings from Workspace Configuration > App Configuration. Before proceeding, verify if you have the following permissions.

  • Workspace subscription: The Workspace subscription is required to create a Workspace URL. If you don’t have a subscription, you can’t add and configure cloud stores. You’ll only be presented with an option to configure on-premises stores.

  • Workspace URL: If you have a Workspace subscription but haven’t added your URL yet, you are presented with the following screen. You can click Claim URL under the App Configuration section to claim your URL.

Claim URL

Configure settings

You can configure settings for Citrix Workspace app from the Citrix Cloud portal. If multiple stores have been configured for your organization, you can configure each of the stores separately.

  1. Go to Citrix Cloud and sign in with your Citrix Cloud credentials.
  2. Navigate to Workspace Configuration > App Configuration.
  3. From the list of configured store URLs, select the store for which you want to map settings and then click Configure.

    URL list

  4. Modify the settings for your preferred platforms as per your requirement.
  5. Click Publish Drafts to save the settings.


It might take a few hours for the settings to be updated to the Citrix Workspace app clients. For more information, see Frequency of fetching updated settings.

Setup email based discovery

Email based discovery service allows end users to sign in automatically using their email addresses. They aren’t required to furnish their store URLs. To enable this service for cloud stores, you need to perform the following steps.

  1. Claim a domain

  2. Create a domain to URL mapping

Claim a domain

To claim a domain:

  1. Go to <>.

  2. Navigate to Claims > Domains > Add Domain.

  3. Enter the domain that you want to claim (example,

  4. Click Confirm.

  5. Copy the DNS token displayed on the screen.

  6. To create a DNS TXT record, go to the service-provider portal and add the DNS token.

  7. To start the verification process:

    1. Navigate to Claims > Domains.

    2. Go to the domain that you have added and click the ellipsis menu.
    3. Select Verify Domain.
    4. Click Start DNS Check.

Once the verification is completed, the status of your domain changes from pending to verified.


You can claim a maximum of 10 domains. If you want to claim more than 10 domains, contact Citrix Support and provide your Customer ID and URL.

Create a domain to URL mapping

  1. Navigate to Claims > Domains.
  2. Go to the domain that you have added and click the ellipsis menu.
  3. Click Add Another Server URL.
  4. Enter the store URL that you want to map to this domain.
  5. Click Save.


It is mandatory to include port number 443 in the store URL. For example,

Configure settings for cloud stores