# Apple Applications

> Add App Store apps and Web Clips for iPhone and iPad, set how they're managed and licensed, add a managed app configuration, and follow version adoption.

Source: https://docs.capaone.com/capaone/mobile-manager/apple-mdm/apple-applications/  
Product: CapaOne — a separate CapaSystems product; do not apply this page to any other.

Under **Apple → Applications** you add the apps you deploy to iPhones and iPads. There are two
application types:

- **App Store app** — an app from the App Store, free or licensed through Apple Business Manager
  (VPP).
- **Web Clip app** — an icon on the home screen that opens a web page like an app.

:::note[Before you start]
**Apple → Applications** is available once Apple management is set up. See
[Apple Push Certificate Setup](/capaone/mobile-manager/apple-mdm/apple-push-certificate-setup/).
To deploy licensed apps, set up [Apple VPP Integration](/capaone/mobile-manager/apple-mdm/apple-vpp-integration/).
:::

## Add an App Store app

1. Go to **Apple → Applications** and click **New**.
2. Select **App Store app**.
3. Search for the app and select it.
4. Fill in the settings. See [App Store app settings](#app-store-app-settings).
5. Save the app, then assign it to endpoints or groups on its **Assignment** tab.

### App Store app settings

| Setting | Description |
|---|---|
| **ManagementFlags** | **Remove the app upon removal of the MDM Profile**, **Prevent backup of app data**, or **Both of the above**. |
| **Removable** | If turned off, the user can't remove the app while it's managed. iOS 14 and later. |
| **Tap to Pay** | Allows the app to use Tap to Pay. |
| **Associated Domains** | Domains to associate with the app. iOS 13 and later. |
| **Domains Enable Direct Downloads** | Allows direct downloads for the associated domains. iOS 14 and later. |
| **VPP Settings** | **Free app. No VPP licenses required**, or **VPP app. VPP licenses required**. A VPP app uses a VPP license when it's linked to a device, if one is available. |
| **Change the management state** | Select **Managed** to take over management of the app if the user already installed it. |

You can also create an app from a VPP license: on **Apple → VPP Licenses**, open the license's
menu and select **Create Application**. See
[Apple VPP License Tracking](/capaone/mobile-manager/apple-mdm/apple-vpp-license-tracking/).

## Add a Web Clip

1. Go to **Apple → Applications** and click **New**.
2. Select **Web Clip app**.
3. Enter the **URL** to open and the **Label** to show under the icon.
4. Click **Select icon** and upload a PNG or JPEG image. The icon can be up to 400 × 400 pixels and
   1 MB.
5. Set the options you need:
   - **Removable** — the user can remove the Web Clip.
   - **Full Screen** — opens the page as a full-screen web app.
   - **Ignore Manifest Scope** — lets pages outside the web app's manifest load in full screen.
   - **Precomposed** — shows the icon without added visual effects.
   - **Application Bundle Identifier** — the app that opens the URL.
6. Save the Web Clip and assign it.

## Add a managed app configuration

A managed app configuration sends settings to an app, such as a server address, when the app is
installed. The app's developer decides which settings the app supports.

1. On **Apple → Applications**, open the app's menu and select **Edit Managed Configuration**.
2. Enter the configuration in one of two ways:
   - As **XML (plist)**, starting with `<dict>`.
   - As a list of keys, each with a type (string, float, boolean, datetime, or int) and a value.
3. Click **Save**.

You can use macros in the values, such as `$user.email$` or `$hwi.serialNumber$`. Point to
**Supported Macros** to see the list.

## Update an app

Open the app's menu and select **Update Application**. CapaOne tries to update the app to the
latest version on all linked endpoints.

## Follow version adoption

Open an app and select the **Versions** tab. It shows how many endpoints run the newest version,
and a table of the installed versions with the number and share of endpoints on each.

## The application list

The list shows each app's name and vendor, **Priority**, the number of **Endpoints** and
**Groups** it's assigned to, and a **VPP** badge for licensed apps. Use the quick filters to find
apps by OS type, whether they're removable, or whether they use VPP.

![Apple Applications list with Priority, Endpoints and Groups columns and VPP badges](/attachments/capaone/apple-applications--application-list.png)

An app's page has the tabs **Summary**, **Endpoints**, **Assignment**, and **Versions**. Before you
delete an app, CapaOne tells you how many endpoints are affected.

## Related

- [Apple Application Deployment](/capaone/troubleshooting/apple-application-deployment/)
- [Self Service Hub](/capaone/mobile-manager/apple-mdm/self-service-hub/)