Rohit Eddy
Apr 19, 2018 · 2 min read

The ability to create custom installation pages has proven to be very popular within our developer community. Today, we are announcing changes to this feature to improve security and to increase the ease of testing.

Security Update

To improve the security of how apps work within Freshdesk, the custom installation page will be sandboxed within an IFrame when it is rendered in the Freshdesk Product UI.

How does this impact you? If your custom installation page relied on certain libraries or stylesheets to be available by default from the parent page, those will no longer be available. You will also need to include our fresh_client library to enable the page to communicate with the product.

What action must you take?

  • Include the complete HTML with all the libraries and stylesheets your install page will need. To maintain design consistency with the product, include our product-specific stylesheets as shown below.
<link rel=”stylesheet” type=”text/css” href=”https://static.freshdev.io/fdk/2.0/assets/freshdesk.css"> 
  • You must include our fresh_client.js to enable communication between your custom installation page and the parent page, through the sandbox.
<script src=”https://static.freshdev.io/fdk/2.0/assets/fresh_client.js"></script>
  • If you are currently using mkp.request in your install page script, please use client.request as shown below
client.request.get("URL", options)....

You can look at the Asana and Custom Installation Page sample apps for more examples of the required changes.

Testing Update

As part of v4.2.1 of the FDK, we included the ability for develoers to local test the custom installation page. When you type in FDK run into your console, you will see the URL that you can use to test the installation page.

You can now test the custom installation page in your development environment

You can now test out the app installation experience. Once you have filled in the fields, you can press the “Install” button to test the app using the entered values.


Please reach out to us at marketplace@freshworks.com if you have any questions about these updates. And follow us on @FWMarketplace

Freshworks Developer Platform Blog

The official Freshworks Developer Platform Blog. We cover platform updates, developer showcases, tutorials, how-tos and much more

Rohit Eddy

Written by

PM, Freshworks Developer Platform

Freshworks Developer Platform Blog

The official Freshworks Developer Platform Blog. We cover platform updates, developer showcases, tutorials, how-tos and much more

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade