# Simple Links vs. Condition Based Links

### Overview <a href="#how-to-use-simple-link-and-condition-based-link" id="how-to-use-simple-link-and-condition-based-link"></a>

In the Library module, there are two types of configureable links when adding items:

**Simple Link:** Opens a direct link to a specified URL.

**Condition-Based Link:** Directs users to different URLs based on specified conditions, such as department, location, or user type.

{% hint style="warning" %}
Only admins can configure these link settings.
{% endhint %}

***

### Simple Link

A simple link is a library item set up to open a direct link or URL, which can be either external or internal.&#x20;

<figure><img src="/files/ti6fxzcmw8FSdZEwuPRz" alt="" width="563"><figcaption></figcaption></figure>

To create a **Simple Link** in the Library module:

{% stepper %}
{% step %}

#### Choose the Location

Navigate to the Library module and click on **Add Items** to open the dialog box for adding new library items.

Select the **Library** and **Category** for your new item.
{% endstep %}

{% step %}

### Choose Item Type

For **Item Type**, choose **Simple Link**. Enter a **Title** for the link as it will appear in the library.
{% endstep %}

{% step %}

### Enter the URL

In the **Link** field, enter the URL you want users to be directed to. Optionally, add a **Description** for the link.
{% endstep %}

{% step %}

### Set the link Appearance

Choose an **Icon Type.** If uploading an icon the minimum size recommendation is 50x50px; Recommended size: 200 x200px
{% endstep %}

{% step %}

### Open Link In

Choose whether the link should open in a new tab or the current tab.
{% endstep %}

{% step %}

### Save

Click **Save & Close** or **Save and Add More** to save the item.
{% endstep %}
{% endstepper %}

Once saved, this **Simple Link** item will appear in the library. When users click on it, they will be taken directly to the specified URL.

<figure><img src="/files/FSAmb0RnCQ89PkKYh95A" alt="" width="375"><figcaption></figcaption></figure>

***

### Condition-Based Link

A condition-based link is a library item with URLs that vary based on specific conditions. If a condition is met, the corresponding URL is opened when the user clicks the link. This allows the same link title to direct different users to different URLs.

<figure><img src="/files/t1JjrU2bWSCsUCnCDYlj" alt="" width="563"><figcaption></figcaption></figure>

To create a **Condition-Based Link**:

1. Navigate to the Library module, click on **Add Items**.
2. Select the **Library** and **Category**.
3. For **Item Type**, select **Condition Based Link**.
4. In the **When** section, choose the appropriate condition for the link. In the above example, **Departments** is selected to create links based on department membership.
5. **Default Condition** (optional): Add a URL to be opened if none of the specified conditions are met.
6. **Additional Conditions**: Set up specific conditions with associated URLs. In the above example:
   * **Sales Department**: Users in the sales department will see the link title as “Sales Marketing Page” and will be directed to the pricing and sales marketing site.
   * **HR Department**: Users in HR will see the link title as “Marketing Website - Conditional Link” and will be directed to the general front page for the marketing website.
7. Add a **Description** for the link, if desired.
8. Select a **Link Color** and **Icon** for easy identification or upload a custom icon. Minimum size: 50x50px; Recommended size: 200px X 200px
9. Choose whether the link should open in a new tab or the current tab.
10. Click **Save & Close** or choose another save option to finalize.

***

#### Conditions Available for Condition-Based Links

In addition to **Departments**, other conditions that can be chosen include:

* **Title**: Based on job titles in MangoApps (can be synced from Active Directory).
* **Organizations**: Based on assigned organizations in the Users module.
* **Platform**: Differentiates between web and mobile access.
* **Projects**: Allows specific links for users in different projects.
* **Groups**: Specifies different links for users in various groups.
* **Office Locations**: Provides links based on location group membership.
* **User Type**: Distinguishes between network users and guest users.
* [**Custom Fields**](https://guides.mangoapps.com/mangoapps-administrators-guide/module-settings/people/full-profile): Uses custom fields created in user profiles to set conditions for specific links.

Multiple conditions can be included, enabling tailored access for different users. For example, if a user belongs to both Sales and HR, they will see **both** department-specific links. If a user does **not** meet any specific condition, they will be directed to the default link if one is set.


---

# 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/libraries/simple-links-vs.-condition-based-links.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.