FAQs for the HTML for Confluence app

Overview

This page provides answers to the most frequently asked questions for the HTML for Confluence app.

FAQ


 Does the app work if the native Confluence HTML module is disabled?

Yes, you can use the HTML for Confluence app if the native Confluence HTML module is disabled. After disabling the native Confluence HTML macro, you must disable and re-enable the BobSwift HTML for Confluence app to work.

 Does the app allow JavaScript?

Yes. A Confluence administrator can toggle the Allow JavaScript switch on the HTML for Confluence Configuration screen to allow Javascript in the HTML macro. Note that this parameter is available from the app version 5.4.0.

 How to display images using HTML macro?
  1. Place the image file in the <confluence_home_directory>/script/filename location.
  2. Log in to your Confluence instance and navigate to the intended space.
  3. Edit the relevant page and include the HTML macro. 
  4. Click Edit and in the Edit 'HTML' Macro screen, enter the filename, with prefix, under Location of HTML data.

  5. Click Save.  
 Is it possible to bulk import HTML pages through this app?

No, it is not possible to bulk import HTML pages using this app.

Alternatively, you can use the Confluence Command Line Interface (CLI) app to bulk import HTML pages. The following code uses the loadFiles action to import HTML files from the specified location and space:

--action loadFiles  --space "spacekey"  --file "<path of the folder which has multiple html pages>" --replace

In the specified location, mime, text/HTML, text/text, and, text/markdown file types are converted to pages. All other file types are added as attachments and all HTML files are wrapped with the HTML macro. Visit the CLI reference site for more information.

 Can I specify the XSLT version to be used with the XSLT macro?

Yes, a xsltVersion parameter is available as part of XSLT macro. This lists the XSLT versions that the macro is compatible with.

Select the version based on your style (XSLT) input document. To learn more, refer to XSLT MacroNote that this parameter is available from app version 5.4.0 onwards.

 What is Restrict URL Access configuration in the app used for?

This parameter controls whether the URL parameter on the HTML macro must conform to the Confluence Whitelist, provided whitelisting is enabled.

Confluence allows the administrator to turn on whitelisting and restrict incoming and outgoing connections to only those connections that are configured in the settings. By enabling this option, the URL parameter for this app is restricted to URLs that are configured in the Confluence Whitelist settings.

 Is it possible to find and replace string using regex?

Yes, it is possible to find and replace string using regex.

In the Edit 'HTML' Macro screen, enter the regex pattern under Find regex patterns and the text to be replaces with under Replacement strings

 Can we display HTML content in an iframe using the app?

Yes, you can display HTML content in an iframe with this app.

In the Edit 'HTML' Macro screen, deselect the Remove conflicting tags option. 

The output of the shown example is:

 Can we display the header section of an HTML file attachment using the HTML macro?

Yes, you can display the header section of an HTML file attachment.

In the Edit 'HTML' Macro screen, check the option Include head section HTML. 

Before selecting the option:

After selecting the option:

 Do we have an option to format the display of an HTML file attachment with JTidy content in Confluence?

Yes, you can format the JTidy content of an HTML file attachment.

In the Edit 'HTML' Macro screen, check the Select to use JTidy option.