# Company Apps

## What is Company Apps

Company Apps is a feature that allows you to group company applications and links into a single space, categorize them, choose their icons, and assign read permissions to specific individuals. \
\
This feature allows the insertion of both **internal SharePoint links** and **external links**.

The apps can be **categorized** and **indexed** in [Advanced Search](https://docs.intranet.ai/configuration/advanced-search). This way, the intranet will show users the most relevant apps for their searches and work.

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

***

## Add the Company Apps 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="/files/l5ySSL5qOCO7zmUJPhxZ" alt="" data-size="line">&#x20;
* Click on it and, in the web part search box, enter **Apps** to quickly find and select the Company Apps web part, which is named "IAI - Apps".

<div align="left" data-full-width="false"><figure><img src="/files/fqTxvMvJaIufiyQo8npA" alt="" width="563"><figcaption></figcaption></figure></div>

* Click the **Edit** **properties** <img src="/files/Q8zdSxihe4szq1uVXd24" alt="" data-size="line"> button on the left of the web part to open the property pane and set options such as Layout settings, Data sources, General settings, Display settings, Default display settings, List display settings, Order settings, and Personal App settings. See below for more information on each of these options.

***

## **Configuration**

1. [Layout settings](#layout-settings)
2. [Data sources](#data-sources)
3. [General settings](#general-settings)
4. [Display settings](#display-settings)
5. [Default display settings](#default-display-settings)
6. [List display settings](#list-display-settings)
7. [Order settings](#order-settings)
8. [Personal App settings](#personal-app-settings)

### Layout settings

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

<div align="left"><figure><img src="/files/6mTmLl7LLaJJBjOCyxp5" 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 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 shadow you want to use**: 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.&#x20;
  * 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.
* **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.
* **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 “Apps” at the top left angle of the webpart.
* **View mode**: you can choose between a default view (each item is represented in a square with an icon and title) or list view (list of saved items). If you choose the default mode, a specific configuration will appear, which is **Default display settings**. If you choose the list view, the specific setting will appear, which is **List display settings**.

<div align="left"><figure><img src="/files/iKueikQLkEdrUC4d72ad" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/SWKs6y7hq1WQMxkCWXsJ" alt=""><figcaption></figcaption></figure></div>

### Data sources

In this section, you need to specify the **sources** from which the web part will **retrieve data**. In addition, you can set other general options.

<div align="left"><figure><img src="/files/clAqudS9Qn89yerpDt0t" alt=""><figcaption></figcaption></figure></div>

Fill out the fields as follows:

* Enter the **site URL from which the apps will be taken from.**

> For example: <https://intranetai.sharepoint.com/sites/Intranet>

* Choose the Apps list data source, which by default is **Apps list**.
* Enter again the **site URL from which the favourites will be taken from.**

> For example: <https://intranetai.sharepoint.com/sites/Intranet>

* Choose the Apps favorites list data source, which by default is **Apps favorites**. &#x20;

### General settings

In this section, you need to set general options for the webpart, such as the showing the link on current page or from a new tab, as well as hiding webpart when no apps are present.

<div align="left"><figure><img src="/files/vqStufWnvISe80qgK9AD" alt=""><figcaption></figcaption></figure></div>

* You can choose to open the link on a new tab from desktop.
* You can decide to hide the web part when there are no apps to view for the current user.
* You can customize the title of the favorites section. If this field is left blank, the default title "Favorites" will be applied.

### Display settings

<div align="left"><figure><img src="/files/bsxl3VLsXvPmm9548jLd" alt=""><figcaption></figcaption></figure></div>

* You can choose to show a search bar to help users find apps more quickly.

{% hint style="info" %}
The **search bar** is **useful** when the section includes **many apps**, as it allows users **to find** an application more **easily**.
{% endhint %}

* **Enable tab mode**: If you enable this option, the user will open the apps area by clicking on a small button. To configure the tab mode, follow these steps:

<div align="left"><figure><img src="/files/cQZxverZYPv2NLfUzYe0" alt=""><figcaption></figcaption></figure></div>

* Enter the **name of the icon** that will be used for the button. You can choose an icon from the library at [this link](https://developer.microsoft.com/en-us/fluentui#/styles/web/icons) and then copy-paste the name of the icon into this field.
* Define the **position** of the button on the page by entering the top margin and the right margin.

### Default display settings

If you have selected the **Default** layout, you will see the following fields::

<div align="left"><figure><img src="/files/leaWzA3EHBS5qV2Aiu7U" alt=""><figcaption></figcaption></figure></div>

* **Select to view tab options**: if you enable this setting, you can customize the font size of the text displayed on the tabs.
* You can choose to open apps in the **current tab** from Teams or from **a new one**.

### List display settings

If you have selected the **List layout**, you will see the following fields:

<div align="left"><figure><img src="/files/EwYHtPnqHYAbMNAliEdE" alt=""><figcaption></figcaption></figure></div>

* You can choose whether the **Favorites** section will be expanded by default. If you don't enable this setting, the section will be collapsed by default.
* You can choose whether the **Personal apps** section will be expanded by default. If you don't enable this setting, the section will be collapsed by default.
* You can choose whether all **other categories** will be expanded by default. If you don't enable this setting, all sections will be collapsed by default.
* You can set the **height** of the web part. If you **enable** this option, an additional field will allow you to enter the height of the web part in pixels.

<div align="left"><figure><img src="/files/2Lo7ceuvkQK9WPUq5ui5" alt=""><figcaption></figcaption></figure></div>

### Order settings

Here you can drag and drop the tabs to choose the order you want to display them.

<div align="left"><figure><img src="/files/8CHJ2RMPPiFvHRLCp6jH" alt=""><figcaption></figcaption></figure></div>

### Personal App settings

Company Apps also allows you to have a section where users can save their **favorite personal links**, which can be both **internal** and **external** to SharePoint. For example: Corriere della Sera (newspaper headlines links)

<div align="left"><figure><img src="/files/NpveoTnhHkotZllHBw3I" alt=""><figcaption></figcaption></figure></div>

Complete the tabs as follows:

* In the first section, you can decide whether to **enable** the Personal Apps tab or **not**. Simply check **Yes** if you want it to be displayed. If set on **No**, the other options will not be possible to configure.
* To position the Personal App tab at the **beginning** of the other tabs, it's necessary to check the second option; otherwise, leave it **unchecked** to position it at the **end**.
* Enter the **site URL** where the list of personal apps is present. For example: <https://intranetai.sharepoint.com/sites/Intranet>
* Choose the list data source, which by default is **User apps list**.
* Enter the name of the tab to be displayed, or it will default to **My Links**.

And this is the front end result:

<div align="left"><figure><img src="/files/ANlyNNZnQkFJA9Hq4xW2" alt=""><figcaption></figcaption></figure></div>

***

## **Add a new company app to your SharePoint intranet**

* To add a business app to your SharePoint intranet, the first step is to log in with your Microsoft 365 account. &#x20;
* Once the homepage of your Intranet is visible, please click on the **Settings icon**, which is located on the top right of the page. Then click on the **Site Contents** link, corresponding to the third link in the settings.

<div align="left"><figure><img src="/files/bnSitQjfbb5vQqxeiFW7" alt=""><figcaption></figcaption></figure></div>

* When you are in **Site Contents**, click on the **Apps list** link.

<div align="left"><figure><img src="/files/HoVPL3roZ3AIKrpHlINs" alt=""><figcaption></figcaption></figure></div>

* &#x20;Click on the **New** button located at the top left.&#x20;

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

* A **pop up will appear** on the right side of the page, with the following fields:

<figure><img src="/files/7ly2VrQQ1Ltl68CiWATq" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The fields marked with (\*) are **mandatory**.
{% endhint %}

* **Title\***: the name of the application you’d like to see in the homepage of your Intranet.&#x20;

> For example: Progress

* **Link**: the pathway referred to by the application (you can include both internal and external SharePoint links).&#x20;

> For example: <https://teams.microsoft.com/l/app/70009fe1-94c8-4379-aa54-b6b174794a3e?source=app-details-dialog>

* **Category\***: here, you can enter the various categories to which the applications belong. For example, websites, updates, search tools, travel, or any other categories your company requires. This information will enable users to view applications grouped by a specific logic when they log in to the Intranet page. A separate tab will be created for each category.
* **Icon name**: the graphic element, it’ll be visible in the homepage of your Intranet, near the Title. In order to choose the correct icon, please [see here](https://developer.microsoft.com/en-us/fluentui#/styles/web/icons) the corresponding code via mouse over it.

> For example: DateTime (calendar with a clock icon)

{% hint style="info" %}
You can also create custom icons, upload the images to SharePoint and insert the link image uploaded to SharePoint in this section.&#x20;

To **create the icon URL**, follow these steps:&#x20;

* Upload the picture to the Site Assets folder in the Site contents (or any other folder on your intranet).
* In the Site Assets document library, select the picture. (1)
* Click on the Info icon at the top right of the screen. (2)
* Click on the **Path icon** to copy the URL of the icon. (3)
* Finally, paste the icon URL into the required field. <br>

  <div align="center"><figure><img src="/files/7ycX91ZmlFhYTzwsL21T" alt=""><figcaption></figcaption></figure></div>

{% endhint %}

* **Order**: the logic of visibility of the applications in the web part.
* Once every mandatory item is filled, please click on the **Save** button.

<div align="left"><figure><img src="/files/GIMx0hlFfe4fNBD5C93E" alt=""><figcaption></figcaption></figure></div>

Business applications are visible on your intranet homepage or in the section where you have placed this webpart. However, you can search for them in the search bar at the top of the page.

***

## **Edit an existing application within your SharePoint intranet**

To edit an existing app, follow these steps:&#x20;

* Click on the **Settings** icon on the top right of the page, then click on **Site contents**.

<div align="left"><figure><img src="/files/nTlfbUPDqEpwMp47g6nJ" alt=""><figcaption></figcaption></figure></div>

* Select the **Apps list**.

<div align="left"><figure><img src="/files/1CcKOqLIPa5J5Aqlf5Gl" alt=""><figcaption></figcaption></figure></div>

* In the **Apps list** panel, please mouse over the application you’re interested in editing and please select it.

<div align="left"><figure><img src="/files/3mBznsv2YDor1ux15TwE" alt=""><figcaption></figcaption></figure></div>

* Once the application is selected, please click on the **Edit** button.

<div align="left"><figure><img src="/files/roVIPZk4NrIVSmFpAEDQ" alt=""><figcaption></figcaption></figure></div>

* Here, the **same pop up** as the creation will appear, and it’ll be possible to amend it as needed. Once the amends are done, please click on **Save**.

<div align="left"><figure><img src="/files/3Z56TJlYjAjkNApqbHhQ" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Please note:** the creation of an application (and the amends on an existing one) can be visible in real time in the homepage of your Intranet, once you click on Save.
{% endhint %}

***

## Configure the Apps favorites list&#x20;

The Apps favorites list requires a **specific configuration** so that users can **interact with the list** and **mark items as favorites**. To learn how to configure this list, read the [dedicated guide](https://docs.intranet.ai/sharepoint-intranet/other-configurations/configuration-of-favorites-lists-and-user-lists). In particular, please refer to the **First type of configuration** section. &#x20;

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


---

# 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://docs.intranet.ai/sharepoint-intranet/components/company-apps.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.