> For the complete documentation index, see [llms.txt](https://docs.labii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.labii.com/widgets/dashboard-widgets/labii/community/refer-a-friend.md).

# Refer A Friend

## Specs

| Label                     | Value                         |
| ------------------------- | ----------------------------- |
| **Version**               | 0.1.0 (updated on 2022-08-31) |
| **Developer**             | Labii Inc.                    |
| **Type**                  | Dashboard                     |
| **Support Configuration** | No                            |

## Overview

The Refer A Friend dashboard widget gives Labii users a simple way to share Labii with colleagues, collaborators, and friends. It provides a visible referral entry point from the dashboard for users who enjoy using Labii and want to recommend it to others. This widget is useful on personal dashboards, customer success dashboards, and shared dashboards for engaged teams.

## Use Cases

* **Referral sharing**: Give users an easy way to recommend Labii.
* **Customer advocacy**: Encourage satisfied users to share their Labii experience.
* **Team expansion**: Help users invite collaborators who may benefit from Labii.
* **Community growth**: Support word-of-mouth adoption from existing users.

## Configuration

The Refer A Friend widget does not require configuration. Add it to a dashboard to display the referral option.

### Initial Setup

{% stepper %}
{% step %}
Navigate to the dashboard where you want users to see the referral option.
{% endstep %}

{% step %}
Click **Add Widget** and select **Refer A Friend** from the dashboard widget catalog.
{% endstep %}

{% step %}
Save the widget to place it on the dashboard.
{% endstep %}
{% endstepper %}

### Required Settings

* **None**: The widget displays Labii-provided referral content.

### Optional Settings

* **None**: The widget is ready to use after it is added to a dashboard.

## Readonly View

### Display Features

* **Referral prompt**: Encourages users to share Labii with others.
* **Dashboard access**: Keeps the referral option visible during regular use.
* **Simple call to action**: Provides a clear starting point for sharing Labii.

<figure><img src="/files/EFbMt5S3zt0pveTaQrAP" alt="Refer A Friend dashboard widget"><figcaption><p>The Refer A Friend widget helps users share Labii with colleagues and friends.</p></figcaption></figure>

### Interactive Features

* **Start referral**: Users can follow the widget action to refer another person.

## Best Practices

* Place this widget on dashboards used by active and satisfied users.
* Pair it with [Feedback](/widgets/dashboard-widgets/labii/community/feedback.md) so users can either share Labii or submit suggestions.
* Avoid placing it on dashboards intended only for urgent operational monitoring.