# Add Data Source

### Overview

MangoApps makes connecting a custom item tracker to the rewards catalog easy with the Add Data Source wizard pop-up. There are 3 steps to this process: selecting your data source, mapping your columns, and configuring the custom catalog settings.

To get started, click the **Add Data Source** button located at the top right of the screen.

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

### Title & Data Source

In this step, you will create a title and description for the new data source. The title input here will **not** be visible to end users. However, it **will** be available to select from a dropdown menu in the **Catalog** section, so it is recommended to make this title descriptive and unique.&#x20;

{% hint style="info" %}
Though the title will not be visible to end users, the description will!
{% endhint %}

In this step, you will also select the tracker that will serve as the custom reward database. Click the box and use the tracker look ahead feature or type in the tracker name.&#x20;

If you do not yet have a custom item tracker setup, click [**Create custom item tracker**](https://guides.mangoapps.com/admin-guide/module-settings/recognition/data-sources/add-data-source/create-custom-items-tracker) to create one.

***

### Column Mapping

In this step, much like importing a spreadsheet to a tracker, you will connect your tracker columns to the required columns for the catalog.

The required mapped columns are: Image, Name, and Value in Points. The other columns listed are all optional but are recommended in order to flesh out the details of the redemption item.

{% hint style="info" %}
If the **Quantity In Stock** column shows 0 items, 'Out of Stock' will be displayed to end users in the quantity amount section for the item.
{% endhint %}

***

### Settings

In this final section, you will configure the Visibility and Helper message settings for the data source.&#x20;

#### Visibility

Select whether the items within this custom catalog will be shown to all users or specific user segments. If a specific user segment is chosen, items from this data source will be visible to only users who are part of the user segments that are configured here. Up to a maximum of 3 user segments can be configured at once per instance of a data source.

#### Add Help Text (Optional)

Customize the Rewards Helper message received by users when they make a redemption. If left blank, just the redemption information will be included in the message.

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

{% hint style="warning" %}

#### What if the Messages Module is disabled for the domain?

When the Message module is deactivated, users will be alerted by **email**. Despite user configured limitations for email data, **they will still receive all pertinent information**, allowing them to stay informed about messages received.&#x20;

By clicking on the **View Message** option within the email, users can effortlessly navigate to the complete message, ensuring they have access to the entirety of the communication.&#x20;

**However**, it is important to note that the default notification settings for this particular type of email **DO NOT** override individual user preferences. The hierarchy of notification settings dictates that to receive these crucial notifications via email, the **notification setting for received messages must be enabled in the user's notification settings**. If, however, this notification setting is **turned off, users will not receive an email alert, and consequently, they won't be able to access the message**. This emphasizes the importance of maintaining the notification settings to ensure effective communication through the appropriate channels.
{% endhint %}


---

# 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/admin-guide/module-settings/recognition/data-sources/add-data-source.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.