Keeping up with release updates for Citrix Workspace app for HTML5 can be challenging, especially if you’re making manual updates with each new version.

Don’t worry. We’ve got you covered. If your site is using HDX SDK for HTML5, it can now consume the latest version of Citrix Workspace app for HTML5 automatically.

Citrix Workspace app for HTML5 version 1908 onward is served from a content delivery network (CDN), and HDX SDK for HTML5, released as part of 1908, can grab the latest code from the CDN. And you don’t have to update HDX SDK for HTML5 files anymore, unless there are actual updates to HDX SDK for HTML5. Now you can move away from hosting the Citrix Workspace app for HTML5 code on your own server, StoreFront, or CDN.

How Do I Get This Feature?

All you have to do is update your server with the latest HDX SDK for HTML5 files (Citrix Workspace app SDK 1908 for HTML5). Then search for citrix.receiver.setPath in your code consuming SDK and change it to citrix.receiver.setPath(“CDN”);. If you’re a new SDK user, the API will have CDN as the default option.

Want to try it out? Get the sample  HTML file. For more information on the various SDK APIs, with examples of code, click here.

You’ll need to update to the latest version of HDX SDK for HTML5 and make these changes to consume from the CDN. Check out the FAQs that follow for more information and share your feedback in the comments below.

Frequently Asked Questions

Do the SDK-related files need to be hosted?
Yes. You will need to continue hosting CitrixHTML5SDK.js, HDXEngine.html and HDXLauncher.js on your server as before.

I am a current HDX SDK for HTML5 user. How do I get the Citrix Workspace app for HTML5 code from the CDN?
Update CitrixHTML5SDK.js, HDXEngine.html, and HDXLauncher.js to the latest versions. In the code, search for citrix.receiver.setPath and change it to citrix.receiver.setPath(“CDN”);.

Can I still host Citrix Workspace app for HTML5 like before and consume from my own server?
Yes. The updated API is backward compatible. However, Citrix recommends that you consume from the CDN.

Is there any fallback mechanism when the CDN is not reachable?
Yes. The enhanced API supports this. When the CDN is not reachable, a fallback location can be set. For example, citrix.receiver.setPath(“CDN”,”http://html5client_hosted_url/”);

When the CDN isn’t reachable, SDK will use the code from the fallback engine path (the URL of Citrix Workspace app for HTML5, hosted by customer as before). If the fallback engine path is not reachable either, SDK would throw an exception.

Does the auto update of Citrix Workspace app for HTML5 give only client-side updates for new features? How about any other dependent components?
Yes. Any other policies or component dependencies must be updated per the feature requirement. You can learn more here.

Is this auto update capability applicable to the Citrix Workspace app for HTML5 installed in StoreFront?
No. This is applicable only for launches via HDX SDK for HTML5 from version 1908 onward, provided the setPath API is set with the option as “CDN.” If your Citrix Workspace app for HTML5 is installed in StoreFront, it should to be updated manually to consume any new updates in addition to what’s already shipped with StoreFront.


Citrix Tech Bytes – Created by Citrix Experts, made for Citrix Technologists! Learn from passionate Citrix Experts and gain technical insights into the latest Citrix Technologies.

Click here for more Tech Bytes and subscribe.

Want specific Tech Bytes? Let us know! tech-content-feedback@citrix.com.