# Quick Links Widget

## Overview

The Quick Links Widget is a multifaceted tool designed to enhance accessibility and streamline information retrieval within your organization. It offers the flexibility to direct users to both external and internal web pages, e.g. accommodating external LMS links for training integration or featuring various directories on your homepage instead of clogging the main navigation menu. 

The Quick Links Widget is an invaluable tool for seamlessly connecting users to documents, forms, and virtually any web-based information. In the context of a Human Resources department, it can significantly ease access to a variety of resources, including HR policy PDFs, specific intranet pages, and online request forms.

<figure><img src="/files/5mh9vpeJZhlFVbzsQnlK" alt=""><figcaption></figcaption></figure>

## Configuring the Quick Links Widget

Click the **Edit** button and the Quick Links pop-up menu will appear. From this pop-up menu, you can add, edit, or remove your quick links list.

<figure><img src="/files/XNWQDOTflmFgSGRHJy8u" alt=""><figcaption></figcaption></figure>

First, you will be asked to select  a template. Out of the box, MangoApps offers 6 different template style:

* **Icon + Text Beneath**&#x20;

<figure><img src="/files/vL7ohRUZe5rpY9soEgVD" alt=""><figcaption></figcaption></figure>

* **Icon + Text Above**

<figure><img src="/files/oNGH5l1AgMm3bINwb7eu" alt=""><figcaption></figcaption></figure>

* **Icon Only**

<figure><img src="/files/8T4zc4uqbOd2EsREVXOc" alt=""><figcaption></figcaption></figure>

* **Icon Left + Text Right**

<figure><img src="/files/9IqLrTUNQtSv0pklJs1a" alt=""><figcaption></figcaption></figure>

* **Text Only**

<figure><img src="/files/1EXZxUXuCmU0W7mgWyTm" alt=""><figcaption></figcaption></figure>

* **Text in Two Columns**

<figure><img src="/files/GvQMqi7STyPrqY6fDIeR" alt=""><figcaption></figcaption></figure>

From this step you can also choose to add more tiles by clicking the **+ Add More** towards the bottom of the pop-up menu (note that you may need to scroll down).

Once you have selected your template, click on a tile to begin customizing your link.

## Link Type

In this section, we will explore the different link types that can be added within the widget.

<figure><img src="/files/feOKP6CvfX3q4MYk261s" alt=""><figcaption></figcaption></figure>

For templates that have icons, you will be prompted to select your icon or choose an icon from various media sources. You have the ability to further customize your icon choice with the Display Settings offered along the right hand menu. As seen below.

<figure><img src="/files/asKkp23GbZOeiOsxfi0f" alt=""><figcaption></figcaption></figure>

There are 5 link types offered from the **Add Link** dropdown menu:

* **Simple URL** - The typical URL for any link.
* **Condition Based URL** - This option allows you to set certain conditions for which URLs will appear in your Quick Links widget. See below for more information. <mark style="color:red;">**Note**</mark><mark style="color:red;">: To set Condition Based URLs for the</mark> <mark style="color:red;"></mark><mark style="color:red;">**Quick Links Widget**</mark> <mark style="color:red;"></mark><mark style="color:red;">in the</mark> <mark style="color:red;"></mark><mark style="color:red;">**Home**</mark> <mark style="color:red;"></mark><mark style="color:red;">module, a Network Admin must access the Quick Links Widget from</mark> <mark style="color:red;"></mark><mark style="color:red;">**Admin Portal -> Modules -> Dashboard**</mark><mark style="color:red;">.</mark> \ <mark style="color:red;">For</mark> <mark style="color:red;"></mark><mark style="color:red;">**Company Pages**</mark> <mark style="color:red;"></mark><mark style="color:red;">and</mark> <mark style="color:red;"></mark><mark style="color:red;">**Team Pages**</mark><mark style="color:red;">, changes can be made by admins through the User Portal by click the</mark> <mark style="color:red;"></mark><mark style="color:red;">**Edit Current Page**</mark> <mark style="color:red;"></mark><mark style="color:red;">tool.</mark>&#x20;
* **E-Mail** - Enter an email address. When this link is clicked, the user's device will prompt them to compose an email using their device's email provider.
* **Phone** - Enter in a phone number. When this link is clicked, the user device's phone provider will prompt them to make a call.
* **Other** - Use this option for any link that does not fit the above criteria.

When clicked, these links can be set to open in a **New Tab** or within the **Same Tab**.

Once you have added all your links, click **Save** in the bottom right of the pop-up screen to save your changes.

## Condition Based URL

This feature gives administrators the ability to create Quick Links that appear selectively, based on various user-related criteria. To access this functionality, go to the **Add Link** section in the Quick Links widget editor's pop-up menu, and select **Condition-Based URL** from the dropdown menu. This action will open a new pop-up menu titled **Set up Conditions**. For the purpose of this example, we will be setting up conditional links for associate insurance forms, but our associates are part of different Locations.

<figure><img src="/files/vqU1PuTnb7yyFQOPo72U" alt=""><figcaption></figcaption></figure>

Links can be given conditions based on the following categories:

* User Title
* Organization
* Office Location
* Group
* Department
* Project
* Access Platform
* User Type
* Custom Fields

<figure><img src="/files/8LdsSgqT1JC2lEZAQnRX" alt=""><figcaption></figcaption></figure>

Each Quick Link option can be associated with <mark style="color:red;">**only one**</mark> category. For instance, you can create a Quick Link that appears when a user's location is set to New York. Users with their location set to New York will see the link to the New York form, while users without the New York location setting will not see any link at all.&#x20;

<mark style="color:red;">However, you</mark> <mark style="color:red;"></mark><mark style="color:red;">**cannot**</mark> <mark style="color:red;"></mark><mark style="color:red;">set a quick link to a multi-category condition, such as New York (Location) District Managers (User Title).</mark>

The **Link Title** is the title text that will appear (as long as a template with Text was selected) in place of the URL. <mark style="color:red;">**CAUTION**</mark><mark style="color:red;">: If you are using a text only template and do not set a</mark> <mark style="color:red;"></mark><mark style="color:red;">**Link Title**</mark> <mark style="color:red;"></mark><mark style="color:red;">an error will occur and the link will not work.</mark>

<figure><img src="/files/jZ6qrE1TNp4JPbhKCyBM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hlu0kjnxCRL1YpwRk0h2" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/user-guide/widget-gallery/quick-links-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.