# Partner Portal

In order to offer a branded experience to your Business Partners (customers, lead partners, investors, etc.), Partner Portal gives you the ability to create a tailor made experience. Partner Portal are providing:

* A customisable login page
* A dedicated user management system
* The ability to customise the Homepage

## Creating a Portal

In the **Settings > Partner Portal** page, click on "Create new Portal" to open the Portal creation form.

<figure><img src="https://34758050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MC1g4I2_CgXd0qAq1P7%2Fuploads%2FcfV3qNKPib8Bl4lVY5sa%2Fimage.png?alt=media&#x26;token=6437c6c4-aea4-4e2a-b884-6b8aa7102091" alt=""><figcaption></figcaption></figure>

You'll need to fill the following information:

* **Name**: This is the display name of the Portal as it will appear in the login page and once users have logged in in the portal.
* **Technical name**: This will be used to build the URL of the portal, in the `https://<technical-name>.portals.whaly.io/` format
* **Color**: This will be used to theme the Login page background
* **Logout URL**: When user are logging out from the portal, this is the URL they will be redirected to.
* **Default home cover** (optional): If you want to customize the Home cover that people will see when they login, this is the image that will be used

At the bottom of the page, you can see the previews of how your Portal will look like based on your current configuration.

## Exposing dashboards to Portal users

When the Portal is created, a dynamic [User Group](https://docs.whaly.io/user-management/user-groups) is automatically created. It'll contain all Portal Users. You can see its name in the Portal page.

<figure><img src="https://34758050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MC1g4I2_CgXd0qAq1P7%2Fuploads%2FvVnD1OCnLPXN1qaEeYgK%2Fimage.png?alt=media&#x26;token=4a7aa1b8-bcf7-4ceb-aded-2f2d450999a9" alt=""><figcaption></figcaption></figure>

To give access to a Report Folder that you want to expose in the Portal, you simply have to grant access to the Folder using the [Sharing menu](https://docs.whaly.io/workspace/sharing-and-collaboration).

## Manage users having access to the Portal

To invite users to get access to the Portal, you should go to: Settings > Partner Portal and then click on the Portal name.

Once you are in the Portal page, you can list the users that have access to the Portal and invite them.

### Individual invitation

By clicking on the **Invite Partner** button, you can enter the Partner information:

<figure><img src="https://34758050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MC1g4I2_CgXd0qAq1P7%2Fuploads%2FZXKc6Ku0A7OgQ4GCcncO%2Fimage.png?alt=media&#x26;token=81d07287-b08f-4fa7-9cf8-b256ba54b760" alt=""><figcaption></figcaption></figure>

**Role**: This will be the role that will define what the User will be able to do in the Portal. You can either create a "View only" experience by giving Report Viewer role to your Partners or build a more interactive experience by giving them the Editor role that will give them the ability to create their own dashboards.

**Email**: This will be the email on which the Invite will be sent

**Attributes** (optional): If you have any [User Attributes](https://docs.whaly.io/user-management/user-attributes) configured, you will be able to fill them for the current Partner here. This will be useful if you want different Partners to see different data when accessing the dashboards. Ex. you could have a "Tenant ID" for each partner so that they can only see the data relevant to them

### Mass invites / edits

As your number of Partners can grow quickly, you can also open the "Bulk update users" tool that will give you the ability to upload a CSV with all Partner information.

<figure><img src="https://34758050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MC1g4I2_CgXd0qAq1P7%2Fuploads%2FO8bstxUm0TXvV0V0i5zG%2Fimage.png?alt=media&#x26;token=7ccb1f0f-4337-451d-a86d-343839ab89d0" alt=""><figcaption></figcaption></figure>

This will give you the ability to mass invite or mass edit existing Partners.

#### API Partner management

Please see:

<https://developers.whaly.io/>
