# Web

### Overview

By default, the landing page is set to the **Home Module** for all users after they log in to your MangoApps domain. Network admins can set up both the default layout and the content that appears on your users’ Home on the User Portal.

![](https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FYGnQ3cFjbGpn6t3zVCij%2F14-04-2025-09-42-26.png?alt=media\&token=8ab1a22d-51af-4ef7-918e-ca6928aa57ed)

***

#### **Fix Widget Height Toggle**

Network admins can setup dashboard using fixed height widgets vs variable height widgets. Fixed height widgets help admins to align up the heights of all the widgets in a row. When toggled **ON** the widget height setting cannot be overridden by end users, to ensure they get a consistent UX.

{% hint style="warning" %}
Widget visibility applies **only** if the user has access to the dashboard. The **most restrictive rule wins** — users must meet **both** dashboard and widget visibility criteria.
{% endhint %}

***

####  **Widget Gallery**

Click the **Widget Gallery** button to scroll through the list of widgets and then click the **+ Add** button to add them to the home page. Each widget dynamically loads the content based on the logged in user's role.

For a full list of the widgets offered by MangoApps, check out the pdf below!

{% file src="<https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FS8N2gBa2GpFE3ucQY3WT%2FMA%20Widget%20Guide.pdf?alt=media&token=a6f3f1d9-78ac-4b2f-831d-a34934aa790c>" %}

{% hint style="info" %}
To see more information on specific widgets, visit their sub-articles under the full module explanation in the [User Guide](https://guides.mangoapps.com/user-guide).
{% endhint %}

***

#### **Publish Dashboard**

Click the **Publish** button to apply the edits made to Home and **append** the changes to the existing Home configurations of users.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FhNWah9TiUBLTAySVieIo%2F01-05-2025-10-19-42.png?alt=media&#x26;token=737e0742-296f-43c7-ac07-1020c81b8ca9" alt="" width="563"><figcaption></figcaption></figure>

When publishing the **default system dashboard**, administrators can choose between two modes: **Fully Customizable** or **Locked**.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FXY16ehYGfI8qtsVkMntS%2F01-05-2025-10-29-16.png?alt=media&#x26;token=12b087bd-ff96-4827-b06c-26f65a1ffe8b" alt="" width="563"><figcaption></figcaption></figure>

In a **Fully Customizable** default dashboard, end users can add, remove, and rearrange widgets. Widgets marked as "locked" by the admin cannot be removed, but users can still move them and edit their properties.

In a **Locked** dashboard, end users are restricted from making any changes—they cannot add, remove, move, or rearrange widgets.

Additionally, when publishing a dashboard, admins have the option to either:

* **Override** any user customizations and apply the updated dashboard to all users, or
* **Skip publishing** the update to users who have already customized their dashboard, applying it only to users who have not made any changes.

{% hint style="danger" %}
&#x20;**Custom dashboards** (those created by admins for specific teams or roles) are **ALWAYS** published in **Locked** mode and **CANNOT** be customized by end users.
{% endhint %}

***

**Preview**

Click to view the Home module settings. When designing the web Home module, real content in the widgets is also shown to help get a better picture of with both design & data. You can preview the new Home module layout before publishing for both web & mobile devices are available.

***

### Adding Widgets to the Home Module

Configure the Home module from the Admin Portal for all users by adding widgets.&#x20;

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2Fxe3kjS9HFC9VjRfLU284%2F03-04-2024-12-05-28.png?alt=media&#x26;token=e7b2c849-ca86-45ca-802a-38fceaa1a293" alt="" width="563"><figcaption></figcaption></figure>

To add widgets:&#x20;

1. Click the **Widget Gallery** button to open the **Add Web Widgets** pop-up.
2. Click the preferred widget to add it. You can search for specific widgets by utilizing the Quick Search bar along the top left of the gallery.
3. Once you have selected all the desired widgets, click **Done**. The selected widgets will begin to  populate at the bottom of the Home module editor.

***

### Layout Options

Once the widgets have been added from the gallery, additional layout options becaome available.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FXWavjHhE81ocMScMJOHq%2Fhjtyu.png?alt=media&#x26;token=fe0f4373-9af7-4d0a-bf24-69697a041203" alt=""><figcaption></figcaption></figure>

1. **Resize** the widgets by dragging the small icon on the bottom right edge of the widget. The widgets can also be drag-and-dropped at the preferred position.
2. Click the **Lock** (<img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lclpq021Ai9jH1_X4gO%2F-Lh96hKyAPpsp2pvzMw9%2F-Lh9AhG7iCYQCfTs1SvM%2FModules%20-Dashboard%20-%20Lock%20Button.png?alt=media&#x26;token=57c1f980-4ba9-49ca-beaf-25e4aba4a34c" alt="" data-size="original">) **icon** to create a sticky widget. A sticky widget ensures that a widget remains on all users home modules permanently — they cannot delete this widget nor change the title. This option still lets users add and remove other widgets.
3. Hover over the **More Options** (<img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lclpq021Ai9jH1_X4gO%2F-Lh96hKyAPpsp2pvzMw9%2F-Lh9BVd6dgy9H4VInBdd%2FModules%20-Dashboard%20-%20More%20Options%20Button.png?alt=media&#x26;token=215b8b54-efc5-41ac-8f58-10195a98573a" alt="" data-size="original">) icon to duplicate, add more, or remove widgets. This menu also allows you to Set Properties for individual widgets.

***

### Set Properties

Clicking this option will open the Set Properties pop-up window. Depending on the widget type selected, additional settings will appear. However, most widgets will possess the following:

#### Title

In a scenario where the page width is fixed at 1200px, such as on Home, Team, or Company pages, using the default font family and size, the following character limits apply to widgets:

* Widgets with a single column display approximately 30 characters before ellipsis appear.
* Widgets with two columns display around 70 characters before ellipsis.
* Widgets with three columns display all 100 characters.

However, in a full-width scenario (exclusive to the Home module), the character limits for widgets are as follows:

* Single-column widgets show approximately 50 characters before ellipsis.
* Two-column and three-column widgets display all 100 characters without ellipsis.

***

#### Header Image

From the admin portal, widgets can be assigned header images. Toggle **Title** to the **OFF** position to use the just the image as the header of the widget.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FXQi3ON4DZBDFUtgEw9pE%2Fimage.png?alt=media&#x26;token=7b592bbf-02e7-400c-a4df-6931c9c32dc8" alt="" width="563"><figcaption></figcaption></figure>

| Width of Widget | Minimum px   | Recommended px |
| --------------- | ------------ | -------------- |
| 1 Column Widget | 400 x 96 px  | 600 x 144 px   |
| 2 Column Widget | 800 x 96 px  | 1200 x 144 px  |
| 3 Column Widget | 1200 x 96 px | 1800 x 144 px  |

{% hint style="info" %}
The image uploaded as the 1 column widget header will also serve as the header image for the widget in mobile.
{% endhint %}

***

#### Visibility

This feature enables you to determine the visibility of the widget, either to all network users or exclusively to specific user segments.

To ensure uniformity in the dashboard layout, we advise adding a widget with an identical column width (1, 2, or 3) below any widget with restricted visibility.

***

{% hint style="info" %}

#### To see how these configurations impact the Home module on the User Portal, see [Home](https://guides.mangoapps.com/user-guide/home) in the User Portal Guide.

{% endhint %}