---
title: "FAQs for the HTML for Confluence app"
canonical: "https://support.appfire.com/space/SUPPORT/89142186/FAQs%20for%20the%20HTML%20for%20Confluence%20app"
format: markdown
---
## <span style="color: #000000">Overview</span>

> Macro (excerpt)
> 
> <span style="color: #000000">This page provides answers to the most frequently asked questions for the </span>*<span style="color: #000000">HTML for Confluence</span>*<span style="color: #000000"> app.</span>

## <span style="color: #000000">FAQ</span>


<details>
<summary>Does the app work if the native Confluence HTML module is disabled?</summary>

<span style="color: #000000">Yes, you can use the </span>*<span style="color: #000000">HTML for Confluence</span>*<span style="color: #000000"> app if the native Confluence HTML module is disabled. After disabling the native Confluence HTML macro, you must disable and re-enable the </span>*<span style="color: #000000">BobSwift HTML for Confluence</span>*<span style="color: #000000"> app to work.</span>
</details>

<details>
<summary>Does the app allow JavaScript?</summary>

<span style="color: #000000">Yes. A Confluence administrator can toggle the </span>*<span style="color: #000000">Allow JavaScript</span>*<span style="color: #000000"> switch on the </span>*<span style="color: #000000">HTML for Confluence Configuration</span>*<span style="color: #000000"> screen to allow Javascript in the </span>*<span style="color: #000000">HTML</span>*<span style="color: #000000"> macro. Note that this parameter is available from the app version 5.4.0.</span>
</details>

<details>
<summary>How to display images using HTML macro?</summary>

1. <span style="color: #000000">Place the image file in the </span>***<span style="color: #000000"><</span>******<span style="color: #000000">confluence_home_directory>/script/filename</span>***<span style="color: #000000"> </span><span style="color: #000000">location</span>*<span style="color: #000000">.</span>*
2. <span style="color: #000000">Log in to your Confluence instance and navigate to the </span><span style="color: #000000">intended space.</span>
3. <span style="color: #000000">Edit the relevant page and include the </span>*<span style="color: #000000">HTML</span>*<span style="color: #000000"> macro. </span>
4. <span style="color: #000000">Click </span>**Edit** and <span style="color: #000000">in the </span>*<span style="color: #000000">Edit 'HTML' Macro</span>*<span style="color: #000000"> screen, enter the filename, with </span>**<span style="color: #000000"># </span>**<span style="color: #000000">prefix, under </span>*<span style="color: #000000">Location of HTML data.</span>*  
> Macro (inline-media-image)
5. <span style="color: #000000">Click </span>**<span style="color: #000000">Save.  </span>**
</details>

<details>
<summary>Is it possible to bulk import HTML pages through this app?</summary>

<span style="color: #000000">No, it is not possible to bulk import HTML pages using this app.</span>

<span style="color: #000000">Alternatively, you can use the </span>*<span style="color: #000000">Confluence Command Line Interface (CLI)</span>*<span style="color: #000000"> app to bulk import HTML pages. The following code uses the </span>**<span style="color: #000000">loadFiles</span>**<span style="color: #000000"> action to import HTML files from the specified location and space:</span>

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

<span style="color: #000000">In the specified location, </span>*<span style="color: #000000">mime</span>*<span style="color: #000000">, </span>*<span style="color: #000000">text/HTML</span>*<span style="color: #000000">, </span>*<span style="color: #000000">text/text</span>*<span style="color: #000000">, and, </span>*<span style="color: #000000">text/markdown </span>*<span style="color: #000000">file types are converted to pages. All other file types are added as attachments and all HTML files are wrapped with the </span>*<span style="color: #000000">HTML</span>*<span style="color: #000000"> macro. </span><span style="color: #000000">Visit the</span> [CLI reference site](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458160/Reference#Reference-loadFiles) <span style="color: #000000">for more information.</span>
</details>

<details>
<summary>Can I specify the XSLT version to be used with the XSLT macro?</summary>

<span style="color: #000000">Yes, a </span>*<span style="color: #000000">xsltVersion</span>*<span style="color: #000000"> </span><span style="color: #000000">parameter </span><span style="color: #000000">is available as part of XSLT macro. This lists the XSLT versions that the macro is compatible with. </span>

<span style="color: #000000">Select the version based on your style (XSLT) input document. </span><span style="color: #000000">To learn more, refer to</span><span style="color: #091e42"> </span>[<span style="color: #091e42">XSLT Macro</span>](https://appfire.atlassian.net/wiki/spaces/HTML/pages/70617219/XSLT+Macro)<span style="color: #000000">. </span><span style="color: #000000">Note that this parameter is available from app version 5.4.0 onwards.</span>
</details>

<details>
<summary>What is Restrict URL Access configuration in the app used for?</summary>

<span style="color: #000000">This parameter controls whether the URL parameter on the </span>*<span style="color: #000000">HTML</span>*<span style="color: #000000"> macro must conform to the Confluence Whitelist, provided whitelisting is enabled.</span>

<span style="color: #000000">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 </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> parameter for this app is restricted to URLs that are configured in the Confluence Whitelist settings.</span>
</details>

<details>
<summary>Is it possible to find and replace string using regex?</summary>

<span style="color: #000000">Yes, it is possible to find and replace string using regex.</span>

<span style="color: #000000">In the </span>*<span style="color: #000000">Edit 'HTML' Macro</span>*<span style="color: #000000"> screen, enter the regex pattern under </span>*<span style="color: #000000">Find regex patterns</span>*<span style="color: #000000"> and the text to be replaces with under </span>*<span style="color: #000000">Replacement strings</span>*<span style="color: #000000">. </span>  
> Macro (inline-media-image)
</details>

<details>
<summary>Can we display HTML content in an iframe using the app?</summary>

<span style="color: #000000">Yes, you can display HTML content in an iframe with this app.</span>

<span style="color: #000000">In the </span>*<span style="color: #000000">Edit 'HTML' Macro</span>*<span style="color: #000000"> screen, deselect the </span>*<span style="color: #000000">Remove conflicting tags</span>*<span style="color: #000000"> </span><span style="color: #000000">option</span>*<span style="color: #000000">.</span>*<span style="color: #000000"> </span>  
> Macro (inline-media-image)



<span style="color: #000000">The output of the shown example is:</span>  
> Macro (inline-media-image)
</details>

<details>
<summary>Can we display the header section of an HTML file attachment using the HTML macro?</summary>

<span style="color: #000000">Yes, you can display the header section of an HTML file attachment.</span>

<span style="color: #000000">In the </span>*<span style="color: #000000">Edit 'HTML' Macro</span>*<span style="color: #000000"> screen, check the option</span><span style="color: #000000"> </span>*<span style="color: #000000">Include head section HTML.</span>*<span style="color: #000000"> </span>  
  
<span style="color: #000000">Before selecting the option:</span>  
> Macro (inline-media-image)

  
<span style="color: #000000">After selecting the option:</span>  
> Macro (inline-media-image)
</details>

<details>
<summary>Do we have an option to format the display of an HTML file attachment with JTidy content in Confluence?</summary>

<span style="color: #000000">Yes, you can format the JTidy content of an HTML file attachment.</span>

<span style="color: #000000">In the </span>*<span style="color: #000000">Edit 'HTML' Macro</span>*<span style="color: #000000"> screen, check the</span><span style="color: #000000"> </span>*<span style="color: #000000">Select to use JTidy</span>*<span style="color: #000000"> </span><span style="color: #000000">option</span>*<span style="color: #000000">.</span>*<span style="color: #000000"> </span>  
  
> Macro (inline-media-image)
</details>