> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/viewer-configuration-overall-process/configuring-tiles/configuring-individual-tile-types/configuring-a-url-tile.md).

# Configuring a URL Tile

This Tile is effectively an "embedded web browser". It can be used to display the content located at a specific URL, (e.g. a web page, Internet/Intranet, etc.), or a related URL, (i.e. Alarm Instructions or Cardholder PDF).

The URL tile can be operated independently from a Viewers Navigation Panel, so can therefore have static configuration. This tile can be added to any Viewer.

**Note:** If you use the URL Tile, ensure the WebView2 component is installed by checking under Windows add\remove programs.

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-a0bd90c9b37c9ef4bacc6071176c29805eddb60b%2Fmsedgewebview2.png?alt=media)

You will also need to disable Internet Explorer under add\remove Windows Features. This will ensure that Microsoft Edge is used as the browser for the URL Tile in preference to Internet Explorer which is still the default browser.

### How to configure

1. Double-click on **URL** on the 'Tile Toolbox'.

   The URL Tile appears on the Configuration Panel section of the screen in preview mode.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-50d986a7df395bf81d12b4c9d3afaa7f18cebcca%2Furl_previewmode.png?alt=media)
2. Move the mouse over the URL Tile you have added, and click on the **Click to configure** button that appears.

   The URL Tile Configuration pop-up displays.

   **Note:** The pop-up differs depending on the type of Viewer you are adding a URL tile to.

   This first example is how it appears on a Monitor Site Viewer.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7d9cf857f5134742be928541e866b1a4c91880b2%2Furltile_monitorsiteviewer.png?alt=media)

   This second example is how it appears on an Alarm Viewer and a Spot Monitor Viewer:

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-a3124b2492909bf3c63161dbeb71437a8dec8fbd%2Furltile_alarmviewer.png?alt=media)

   The only difference when it appears on a Cardholder Viewer or a Controlled Challenge Viewer is that there is no option to select an **Alarm Instruction**.
3. Enter an appropriate **Title** for this tile.
4. Uncheck the **Show Tile Header** checkbox if you want the tile header to be removed in operational mode.

   **Note:** While this feature maximises the available screen real estate, be aware of the following impacts this has:

   * Tile maximise/minimise can only be achieved using hot keys < **Ctrl** + **M** >
   * The URL tile cannot be manually refreshed
   * Hiding navigation options on the URL tile means that you cannot navigate back once you have clicked away.
5. Click the appropriate URL related radio button for what you want to show on this tile.

   Which radio button did you click?

   <table><thead><tr><th width="193">If...</th><th>then...</th></tr></thead><tbody><tr><td>Specific URL/File,</td><td><p>either enter a <strong>Specific URL/File</strong> or click the <img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-eb8b7e19f56793693de4c172c25d4dd7bf3e4fbf%2Fselectcardtype_button.png?alt=media" alt=""> button to use the browse tool to make your selection.<br><strong>URL Addressing:</strong></p><p>There are 3 possible URL addresses, as follows:</p><ul><li>a website (internal to an intranet or external to the www Internet)</li><li>a specific file (within a Local area or internal shared network)</li><li>a specific folder</li></ul><p>The following addressing schemes (protocols) are supported:<br><strong>file://</strong>, <strong>http://</strong> and <strong>https://</strong><br><br><strong>Note:</strong> You only need to enter "www" or a drive letter, (e.g. D) without the need to pre-pend with protocol.</p></td></tr><tr><td>URL Personal Data Field,</td><td><ol><li>Click the <strong>Select PDF</strong> button.<br>A browse tool displays.</li><li>Check the PDF you want to use.</li><li>Click the <strong>OK</strong> button.<br>The pop-up closes and the <strong>Select PDF</strong> button changes to the name of the Personal Data Field you selected.<br><br><strong>Note:</strong> If you are adding this tile to a Monitor Site Viewer, the <strong>Last Cardholder at Door</strong> field displays. You must select a Door. The tile will display the URL PDF value of the Cardholder who most recently badged a credential at this Door’s entry reader. A local or remote Door can be selected.</li></ol></td></tr><tr><td>Alarm Instruction<br><br><em>(Only if tile is being added to an Alarm Viewer)</em></td><td>a URL which has been set up against an individual Alarm Instruction (in Configuration Client) will be used.</td></tr></tbody></table>
6. Click the appropriate Navigation radio button, as follows:

   <table><thead><tr><th width="193">If you click...</th><th>then in operational mode...</th></tr></thead><tbody><tr><td>Enable Navigation,</td><td>the Navigation bar will be visible and available, (i.e. users will be able to type any URL they like in the Address bar, and all the navigation buttons will be available).</td></tr><tr><td>Enable Restricted Navigation,</td><td>users will be able to navigate through all the displayed links in the site but the URL cannot be changed. The Address bar and <strong>Go</strong> button will be visible but permanently disabled, while all other buttons will be available.</td></tr><tr><td>Disable Navigation,</td><td>the Navigation bar will not be displayed, therefore disabling any navigation for links in the displayed pre-configured site.</td></tr></tbody></table>
7. Click the **Automatically Refresh Tile** checkbox if you require the URL tile to automatically refresh at a set interval.

   **Note:** Some websites already update automatically within the browser, and there is no need to refresh the tile. However, if the file is a static html or PDF the refresh icon needs to be pressed to refresh the tile.
8. Specify the refresh frequency in seconds, minutes or hours.

   **Notes:**

   * The refresh frequency minimum is 60 seconds.
   * If the "Auto refresh option" is selected and "Navigation is enabled" the tile will refresh the screen the tile has currently viewed.
9. Click the **Close** button.

   The preview mode of the URL Tile now displays the title given, and displays a mock representation of live data.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-aa8cf3607949af38c420b05270892401d433ce4a%2Furltile_configuredpreview.png?alt=media)

   **Note:** This example is how the tile preview will appear when navigation has been disabled, (i.e. the Navigation bar does not display).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/viewer-configuration-overall-process/configuring-tiles/configuring-individual-tile-types/configuring-a-url-tile.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
