Get started

Set up

Desktops and applications appear after logging in. You can search for resources and click an icon to start a desktop or application in a new window.

When you start an additional application, Citrix Workspace app for Chrome OS checks if the application can be launched in an existing session before creating a new session. This enables you to access multiple applications in a single session.

You can configure the features and functionalities of Citrix Workspace app for Chrome OS using any of the following methods:

  • Google Admin Policy
  • Web.config in StoreFront
  • default.ica
  • configuration.js

Note:

As of version 1901, the splash screen is no longer visible to users. The schema “splashScreen”: false” will no longer be supported in future releases. You must remove the schema, if present, from the Google Admin policy or the configuration.js file.

Using Google Admin policy

Note:

Citrix recommends using this method only when Citrix Workspace app for Chrome OS is repackaged for users.

Before Version 2.1, only store or beacon related configurations could be pushed through the Google Admin Policy. For additional information about this policy, see Knowledge Center articles CTX141844 and CTX229141.

With Citrix Workspace app for Chrome OS Version 2.1, other Chrome configurations can also be pushed through the Google Admin Policy.

How to push policies through Google Admin console

To push any policy through Google admin console, follow these steps:

  1. In the Google Admin console, select Devices > Chrome > Apps & extensions > Users & browsers.
  2. Search for Citrix Workspace app (enter the web store app id, for example, haiffjcadagjlijoggckpgfnoeiflnem).
  3. Click the Citrix Workspace app icon.
  4. The policy for extensions will appear. Copy and paste the policy or upload the policy.txt file with the relevant JSON.
  5. Click Save.
  6. Repeat the steps above for Kiosk and Managed guest sessions as required.

Policy

For more information, see Google support.

Verifying the configuration of policies

To verify that policies are pushed correctly, do the following:

  1. Navigate to chrome://policy/.

  2. Click Reload policies.

  3. Search for the Citrix Workspace app for Chrome OS Web Store ID, which is haiffjcadagjlijoggckpgfnoeiflnem.

    • If policies are pushed successfully from the Google Admin Console, they appear under the Web Store ID: haiffjcadagjlijoggckpgfnoeiflnem. If not, verify that the policies are configured correctly. To create or edit the policy, make sure to use the Configuration Utility Tool.

    • If the policies appear under the Web Store ID but do not take effect in the session, contact Citrix Technical support.

Using webconfig

Note:

Citrix recommends that you use the web.config file method for configuration purposes only when a store version of Citrix Workspace app for Chrome OS is being used.

To change the configuration using the Web.config file method (only for those using on-prem StoreFront):

  1. Open the web.config file for the Citrix Receiver for Web site. This file is typically located in C:\inetpub\wwwroot\Citrix\<storenameWeb>, where storename is the name specified for the store when it was created.
  2. Locate the chromeAppPreferences field and set its value with the configuration as a JSON string.

For example:

chromeAppPreferences = ‘{“ui”: {“toolbar”: {“menubar”: false}}}’

Another sample example is as follows,

Webconfig sample

Using the default.ica file

Note:

Citrix recommends that you use the default.ica file method for configuration purposes only for Web Interface users.

Citrix Workspace app for Chrome OS allows Custom. ica files without any initial program value.

To change the configuration using the default.ica file:

  1. Open the default.ica file typically located at C:\inetpub\wwwroot\Citrix\<site name>\conf\default.ica for Web interface customers, where sitename is the name specified for the site when it was created. In the case of StoreFront customers, default.ica file is typically located at C:\inetpub\wwwroot\Citrix\<Storename>\App_Data\default.ica, where storename is the name specified for the store when it was created.
  2. Add a new key at the end of the file, chromeAppPreferences with its value set to configuration as the JSON object.

For example:

chromeAppPreferences={“ui”:{“toolbar”: {“menubar”: false}}}

A sample default.ica file looks like the below:

Default ica file

Using the configuration.js file

The configuration.js file is located in the ChromeApp root folder. Access this file directly to make changes to Citrix Workspace app for Chrome OS.

Note:

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app to make additional modifications to toolbar elements.
  • In kiosk mode, the toolbar is hidden by default. When editing the configuration.js file to enable the toolbar, ensure that kiosk mode is disabled. Citrix recommends that you use one of the alternative methods (for example, the default.ica file) to enable the toolbar.
Get started