# Welcome Box

## What is Welcome Box

Welcome Box is a **welcome space to greet users in your SharePoint intranet**, where you can say hello and provide quick access to recommended resources and/or the personal profile. Thanks to this feature, you can encourage personal profile completion and **increase site visits** by offering **helpful content and links** for your colleagues' daily tasks.

{% hint style="info" %}
Explore the **advantages** of Intranet.ai **Welcome Box** by [**clicking here**](https://intranet.ai/features/welcome-box/) to learn more.
{% endhint %}

***

## Add the Welcome Box web part to a SharePoint page

* If your page is not already in edit mode, click **Edit** at the top right of the page.
* Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this: <img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FccHplKgXfibd4tktmhas%2Fadvanced-search-2.png?alt=media&#x26;token=7d703967-c3f7-4125-834b-f695362bf90b" alt="" data-size="line">&#x20;
* Click on it and, in the web part search box, enter **Welcome Box** to quickly find and select the Welcome Box web part, which is named "IAI - Welcome Box".

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2Fk4vs5Ecpj5Pt27NheV8g%2F1.png?alt=media&#x26;token=d3e3eaf8-b124-49be-ad6c-fa967479ca3a" alt=""><figcaption></figcaption></figure></div>

* Once the web part is added, it defaults to the following view, with two default icons displayed on the buttons below the image.

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2F23V66mEdN1L6utogVyS8%2FWelcomeBox3.png?alt=media&#x26;token=c53204f1-665e-42a9-8ad0-099c03128036" alt=""><figcaption></figcaption></figure></div>

* Click the **Edit** properties <img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FKFt3AdLljq8Uj80fd7Wy%2Fimage.png?alt=media&#x26;token=0c1cc940-61df-4ba2-8c5c-d42403405685" alt="" data-size="line"> button on the left of the web part to open the property pane and set options such as View settimgs, Profile settings, Settings, Left icon settings and Right icon settings. See below for more information on each of these sections.

***

## Configuration

1. [View settings](#view-settings)
2. [Profile settings](#profile-settings)
3. [Settings](#settings)
4. [Left icon settings](#left-icon-settings)
5. [Right icon settings](#right-icon-settings)

### **View settings**

The layout settings allow you to customize the appearance of your application by adjusting various layout settings.

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FhQAk4O9n4DQ0E35IUbmQ%2FWelcomeBox1.png?alt=media&#x26;token=c27857c1-fabd-456e-a0db-d6869ca050e8" alt=""><figcaption></figcaption></figure></div>

By opening this first configuration, you will see the following options:

* **Do you want to hide the background?** You can choose to hide or display the webpart background. The default setting is “No”. This means that, by default, the webpart is characterized by a white background. If you enable this option, the white card background will be completely removed, allowing the content appear directly on the page. As a result, the webpart will be transparent, showing either the selected background image or the chosen SharePoint page color.
* **Do you want to hide the background shadow?** You can choose whether to show or hide the background shadow. The default setting is “No”. This means that, by default, the webpart is characterized by a subtle depth effect that can make the webpart stand out more against the rest of the page. If you enable this option, the shadow behind the background will be removed, giving the web part a flatter, cleaner look without any depth.
* **Select the type of background shadow**: if you decide to set the background shadow, a further configuration will appear and you can select the style from **High Contrast, Light, or Dark** options.
  * If you select **High contrast**, this option creates a strong, bold shadow effect that provides a high level of contrast between the background and the content.
  * By choosing the **Light background shadow**, it will create a soft and subtle effect, giving a more delicate and gentle depth to the background.
  * Finally, the **Dark background shadow** style provides a darker, more intense effect, adding depth and emphasizing the background even more.
* **Enter the title of the application:** thanks to this configuration, you can customize the application title. If you keep it blank, SharePoint will show the default title "Welcome box" at the top left angle of the webpart.
* **Do you want to hide the title?** Here you can select whether to show the webpart title or hide it. If set to visible, the web part title will appear on the left side.
* **Mobile view in 3 columns**: activating this option allows you to adopt the mobile view, which is more compact than the default one.&#x20;

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FnXijEPlxWO06yZAhLYJf%2FWelcomeBox6.png?alt=media&#x26;token=201e4587-f208-46ec-85c2-7f06bc2d1386" alt=""><figcaption><p>Default view</p></figcaption></figure> <figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FIJEBOyo79RzS6CjkCUyh%2FWelcomeBox4.png?alt=media&#x26;token=42ae69c2-44d8-4bdd-aa4b-a4fc281839b4" alt=""><figcaption><p>Mobile view</p></figcaption></figure></div>

* **Do you want to hide the webpart on mobile devices?** If you activate this option, Welcome Box won't be displayed on mobile devices.

### **Profile settings**

In this section, you can link the user's personal profile to the Welcome Box web part.

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FkBGDPyx4mwPlaq4ltqud%2F3.png?alt=media&#x26;token=e5914200-6e7c-4ad1-9d90-715fa36f7e4e" alt=""><figcaption></figcaption></figure></div>

* **Insert user link:** here you can input the link to the [**My Profile**](https://intranet.ai/features/my-profile/) page (if available). If you fill in this field, you'll be able to access the above-mentioned section by clicking on the profile picture.
* **Select where to open the page:** you can choose to open the link on a new page or the current page.

{% hint style="info" %}
**Please note**: it is not mandatory to fill in these fields.
{% endhint %}

### Settings

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2F2O4m7JKDsroJGiEufLmd%2F4.png?alt=media&#x26;token=0817124f-cd4b-4cca-baaa-f0c2e134a218" alt=""><figcaption></figcaption></figure></div>

In this section, you can customize the text of the **welcome message**. Three placeholders are supported:&#x20;

* **{givenName}**: the web part replaces this placeholder with the user's name;
* **{surname}**: the web part replaces this placeholder with the user's surname;
* **{welcomeText}**: the web part replaces this placeholder with a localized text which changes according to the current time:\
  \- From 6 AM to 1PM: "Good morning"\
  \- From 1PM to 6PM: "Good afternoon"\
  \- From 6PM to 6AM: "Good evening"

> For example: {welcomeText}, {givenName} {surname}!

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2F4f1JjvGXJmREIxG1gVMA%2FWelcomeBox5.png?alt=media&#x26;token=9e0ba93c-27d9-4183-bc43-1a2efe38ad25" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
The placeholder {welcomeText} starts with an uppercase letter if it is placed at the beginning of the text or after a period; otherwise, it is all lowercase.
{% endhint %}

You can choose whether to include all placeholders or select just one or two. If you leave this field blank, Welcome Box will only show the user's name and surname, which is the default behaviour of the web part.

### **Left icon settings**&#x20;

In this section, you can customize the left button by choosing a link and an icon.

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FZWOZs7db9McHYvBCGbhX%2F6.png?alt=media&#x26;token=2eeba59c-48b9-4d25-b9e9-5d1c355253ed" alt=""><figcaption></figcaption></figure></div>

* Insert the **link** to associate with the **left button**.&#x20;

> For example: <https://intranetai.sharepoint.com/sites/iai-demo-saas/SitePages/SystemPages/MyProfile.aspx>

* Type the name of the **icon**. You can find the list of the available icons[ here](https://developer.microsoft.com/en-us/fluentui#/styles/web/icons).

> For example: People

* You can also choose whether to open the link on a new page or the current page.

### **Right icon settings**&#x20;

In this section, you can customize the right button by choosing a link and an icon.

<div align="left"><figure><img src="https://2718234637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FriXlnuemuParrCf7Uotu%2Fuploads%2FtaY4Oaq8HUxxo9KVbWxv%2F7.png?alt=media&#x26;token=56f847e3-db91-4ac4-af72-bee2a0c3173e" alt=""><figcaption></figcaption></figure></div>

* Insert the **link** to associate with the **right button**.&#x20;

> For example: <https://intranetai.sharepoint.com/sites/iai-demo-saas/SitePages/SystemPages/People-directory.aspx>

* Insert the **icon**. You can find the list of the available icons[ here](https://developer.microsoft.com/en-us/fluentui#/styles/web/icons).

> For example: Phone

* You can also choose whether to open the link on a new page or the current page.

{% hint style="info" %}
**Please note**: the button links can be changed at any time and are visible to all users.
{% endhint %}

{% embed url="<https://intranet.ai/>" %}
