Test JSM Cloud Widget before public release

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

As an administrator, you can easily test your Project Widget setup by creating a local HTML file and adding the widget script from your JSM project.

Solution

Steps to test the functionality of the Widget

The test can be accomplished by following a few simple steps:

1. Find your Widget script under Project settings > Channels & self service> Widget > expand Embed code.

2. Open a text editor of your choice.

3. Create a new text file and input a test HTML page code containing the widget embed code. For example:

1 2 3 4 5 6 <!DOCTYPE html> <html> <body><h1>This is a test page for the JSM widget</h1> /replace this whole line with your widget Embed code from JSM/ </body> </html>

4. Save the file with the .HTML extension to convert it to an HTML file.

5. Open the .HTML file with a browser of your choice and look for the widget button.

Please note that it might take one or two seconds for the button to appear.

Things to watch out for

When you create the local HTML file, make sure to use plain text format. If your editor adds any metadata, the file might not render correctly.

Some text editors, like TextEdit on MacOS, work with RichText format by default and require adjustments in the settings to use plain text instead.

Updated on April 17, 2025

Still need help?

The Atlassian Community is here for you.