> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/user-guide/libraries/simple-links-vs.-condition-based-links.md).

# 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.