---
title: "Configuration - cloud"
canonical: "https://support.appfire.com/space/XL/76611721/Configuration%20-%20cloud"
format: markdown
---
> Macro (aura-html)

<span style="color: #000000">This page provides instructions for configuring the Excel for Confluence cloud app by Appfire. You can customize this app using various configuration options explained in the following sections.</span>

<span style="color: #000000">After upgrading or </span><span style="color: #000000">[installing](https://appfire.atlassian.net/wiki/spaces/XL/pages/76614017)</span><span style="color: #000000"> the Excel for Confluence app, follow the steps mentioned below to navigate to the Global configuration:</span>

1. <span style="color: #000000">Log in </span>to <u>[https://admin.atlassian.com/](https://admin.atlassian.com/)</u><u> </u><span style="color: #000000">as a Confluence administrator </span>and select your **organization**.
2. In the left navigation pane, go to **Apps **and under **Sites**, click the **Site** name.
3. The **Site settings** page opens.
4. Under **Site settings**, click **Connected apps**.
5. From the **Connected apps** page, you can view, update, configure, and uninstall installed apps.
6. Search for Excel for Confluence and click **More actions **(…).
7. Click **Configure,** and the **Excel for Confluence** **Configuration** page opens.

<span style="color: #000000">This page</span><span style="color: #000000"> explains the various configuration settings that control the display of Excel content. Click any of the following links for more details:</span>

- <span style="color: #000000">[Global configuration](https://appfire.atlassian.net/wiki/spaces/XL/pages/76611721/Configuration+-+cloud#globalconfig)</span>
- <span style="color: #000000">[Allowlist](https://appfire.atlassian.net/wiki/spaces/XL/pages/76611721/Configuration+-+cloud#allowlist)</span>
- <span style="color: #000000">[Profiles](https://appfire.atlassian.net/wiki/spaces/XL/pages/76611721/Configuration+-+cloud#profiles)</span>

## > Macro (anchor)

<span style="color: #000000">Global configuration</span>

<span style="color: #000000">Use the toggles to enable or disable the settings.</span>

![image](media://ef6f4fe0-a84d-44d4-b260-35a974b36af2)

<span style="color: #000000">As an administrator, you can:</span>

| **Parameter** | **Default** | **Description** |
| --- | --- | --- |
| <span style="color: #000000">Maximum</span><span style="color: #000000"> file size</span> | <span style="color: #000000">*1*</span> | <span style="color: #000000">Enter the maximum size of the Excel file to be processed, in MBs. If a user tries to upload a file larger than the specified size, an error message is displayed.</span><br>> ⚠️ <span style="color: #000000">When the size is set to a value >1 MB, the user may encounter unexpected errors while uploading an Excel file.</span> |
| <span style="color: #000000">Maximum row limit</span> | <span style="color: #000000"><empty></span> | <span style="color: #000000">Enter the maximum number of rows to be displayed from an Excel workbook. If defined, the specified number of rows are displayed from each worksheet in the workbook. Leave the field empty to display all rows.</span> |
| > Macro (anchor)

<span style="color: #000000">Restrict URL access</span> | <span style="color: #000000">Off</span> | <span style="color: #1d1c1d">Enable this option to restrict the macro to only those URLs listed in the allowlist.</span> |
| <span style="color: #000000">Disable anti-xss mode</span> | <span style="color: #000000">On</span> | <span style="color: #000000">Disable this option to globally turn off anti-XSS mode for all instances of the </span><span style="color: #000000">*Excel*</span><span style="color: #000000"> macro. Administrators must ensure to take appropriate precautions as disabling this option can cause potential security risks.</span> |
| <span style="color: #000000">Help us improve the product</span> | <span style="color: #000000">On</span> | <span style="color: #000000">Enable this option to report usage data that helps us improve the app continually. The app does not send any private user data or personally identifiable information. </span><span style="color: #172b4d">For more information, refer to the </span><span style="color: #000000">[Data security and privacy](https://appfire.atlassian.net/wiki/spaces/XL/pages/76612107)</span><span style="color: #000000">.</span> |

## > Macro (anchor)

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

<span style="color: #000000">Manage the URLs that the app can access from this page. If the </span><span style="color: #000000">*[Restrict URL access](https://appfire.atlassian.net/wiki/spaces/XL/pages/76611721/Configuration+-+cloud#globalconfig)*</span><span style="color: #000000"> option is enabled, t</span>he app<span style="color: #000000"> is restricted to allow the specified URLs only.</span>

![image](media://a685be49-3424-4106-be0b-0c3278131784)

| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- |
| <span style="color: #000000">Expression</span> | <span style="color: #000000">Enter a URL or an expression here.</span> |
| <span style="color: #000000">Type</span> | <span style="color: #000000">Select a type from the following list:</span><br>- <span style="color: #000000">*Domain name *</span><span style="color: #000000">- allows URLs of a specific domain. Example: https://www.example.com/.</span>
- <span style="color: #000000">*Exact match *</span><span style="color: #000000">- allows only the specified URL. Example: https://www.example.com/thispage.</span>
- <span style="color: #000000">*Wildcard expression *</span><span style="color: #000000">- allows all matching URLs. Use * as a wildcard character to replace one or more characters. Example: https://*example.com.</span>
- <span style="color: #000000">*Regular expression *</span><span style="color: #000000">- allows all URLs matching the specified regular expression. Refer to</span> [this link](https://en.wikipedia.org/wiki/Regular_expression) <span style="color: #000000">for more information about regular expressions. Example: http(s)?://www\.example\.com. </span> |

<span style="color: #000000">You can perform the following actions on this page:</span>

- <span style="color: #000000">**Add**</span><span style="color: #000000"> the URL after specifying the </span><span style="color: #000000">*Expression*</span><span style="color: #000000"> and </span><span style="color: #000000">*Type*</span><span style="color: #000000">.</span>
- <span style="color: #000000">**Update**</span><span style="color: #000000"> after modifying the details. Select the </span><span style="color: #000000">*Expression*</span><span style="color: #000000"> to enable editing of the URL.</span>
- <span style="color: #000000">**Delete**</span><span style="color: #000000"> to remove the URL.</span>
- <span style="color: #000000">**Save**</span><span style="color: #000000"> after adding or modifying any URL in the list.</span>

## > Macro (anchor)

Profiles

<span style="color: #000000">Profiles consist of a set of basic parameters that allow users to access content from external sources in the macros. With profiles, you can:</span>

- <span style="color: #000000">Allow user authentication required by some URLs to be hidden from page viewers and editors. Confluence administrators can access this information.</span>
- <span style="color: #000000">Reuse a shared definition for URL access; thus, enable quick macro configurations. </span>
- <span style="color: #000000">Provide base URLs to make fewer changes to page content if these URLs are relocated. </span>
  - <span style="color: #000000">Macro configured URL (not a full URL but a relative path) is appended to the profile provided URL to access the actual location of the files.</span>

![image](media://db578d89-49f4-45f2-a9c7-7084fb4b06b8)

<span style="color: #000000">The page displays a list of profiles available for the macros. Click </span><span style="color: #000000">**Add Profile**</span><span style="color: #000000"> to open a pop-up window as:</span>

![image](media://d8baa01f-be84-434e-ae93-d4b3df800b91)

| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- |
| <span style="color: #000000">Profile name</span> | <span style="color: #000000">Enter a name for the profile.</span> |
| <span style="color: #000000">Profile type</span> | <span style="color: #000000">Displays URL as selected, by default. </span> |
| <span style="color: #000000">URL</span> | <span style="color: #000000">Enter the URL to be accessed.</span> |
| <span style="color: #000000">User; Password</span> | <span style="color: #000000">Enter the user name and password to access the specified URL.</span> |
| <span style="color: #000000">Access token</span> | <span style="color: #000000">Enter the access token to access the specified URL, if needed. Administrators must generate the access tokens from applications, if required, and enter that here.</span> |
| <span style="color: #000000">URL parameters</span> | <span style="color: #000000">Mention any extra parameters that must be appended to the URL here. </span> |
| <span style="color: #000000">Request headers</span> | <span style="color: #000000">Displays the request header(s) created as per the given information.</span> |

<span style="color: #000000">You can perform the following actions on this page:</span>

- <span style="color: #000000">Click </span>:edit: <span style="color: #000000">to edit the profile details.</span>
- <span style="color: #000000">Click </span>> Macro (inline-media-image)

<span style="color: #000000"> to remove the profile.</span>
- <span style="color: #000000">Click </span><span style="color: #000000">**Save profile**</span><span style="color: #000000"> to create the profile.</span>