Skip to main content

Install Apple Business VPP Apps

With Apple Business Manager (ABM), you get apps in bulk, free or paid, through Apple's Volume Purchase Program (VPP), now called Apps and Books. Swif syncs those app licenses, and installs the apps on your Macs, iPhones, and iPads.

No Apple ID is needed on devices. When you install a VPP app to a device group, Swif licenses it to each device's serial number. Devices don't need a Managed Apple ID, and supervised iPhones and iPads install the app silently. This suits shared devices, such as site iPads, kiosks, and classroom devices.


Two ways to license apps

Install to

License

Managed Apple ID

Best for

A device group (recommended)

Device-based. Licensed to each device's serial number.

Not needed

Company-owned and shared devices

Selected devices

User-based. Licensed to the device owner's Managed Apple ID.

Needed, on the device owner's employee record in Swif

When licenses should follow a person

To install on a single device without a Managed Apple ID, add it to a device group, for example a group with just that device, and install to the group. Selected devices lists only devices whose owner has a Managed Apple ID.


Where VPP apps can be installed

Device

VPP apps

How they install

Supervised iPhone or iPad, enrolled with Automated Device Enrollment

✅

Silently, with no prompt

Unsupervised, company-owned iPhone or iPad

✅

The user taps Install

Personal iPhone or iPad, with User Enrollment

✅, user-based licenses only

The user taps Install. Apple doesn't allow device-based licenses here, so install to Selected devices. Apps are removed if the user removes Swif.

Company-owned Mac, enrolled with Automated Device Enrollment, Enrollment SSO, or the Swif installer

✅

Silently

Personal Mac

❌

Apple doesn't allow managed VPP apps on personal Macs, so installs fail


Set up VPP in Swif

1. Download your content token from Apple Business Manager

  1. Click your name at the bottom of the sidebar, then Preferences > Payments & Billing.

  2. Under Apps and Books, scroll to Content Tokens, and click Download next to the location you need.

2. Upload it to Swif

  1. In Swif, go to Device Management > Applications.

  2. Click Add Application, and select Import Apple VPP apps.

  3. Enter an Account Name, and upload the token file.

  4. Click Save.

Swif imports the apps you've acquired in Apple Business Manager. They appear on the VPP Applications tab.

3. Get licenses for each app

In Apple Business Manager, get enough licenses for every device or user that needs the app. Free apps need licenses too. Each device or user uses one.

4. Install apps

  1. On the VPP Applications tab, find the app, and click Install.

  2. Choose where to install it:

    • Device groups, for device-based licenses. No Managed Apple ID is needed.

    • Selected devices, for user-based licenses. The devices' owners need a Managed Apple ID.

  3. Confirm.

5. Renew the token every year

Content tokens expire after one year. Download a new one from Apple Business Manager, and upload it in Swif, to keep installing and updating apps.


Example: install an app on shared iPads, without Apple IDs

Shared devices, such as site iPads, kiosks, or classroom iPads, often can't have Apple IDs. Install to a device group, so each iPad gets a device-based license, licensed to its serial number.

For example, to install Tailscale on site iPads:

  1. Go to Device Management > Device Groups, and create a group for the iPads. A smart group, for example with the operating system set to iPadOS, adds new iPads automatically.

  2. Go to Device Management > Applications, and open the VPP Applications tab.

  3. Find Tailscale, and click Install.

  4. Choose Device groups, select the iPads' group, and confirm.

On supervised iPads, Tailscale installs silently, with no Apple ID and no prompt.

Check before you start

  • Supervised iPads: iPads enrolled through Apple Business Manager are supervised. Unsupervised iPads always ask before installing.

  • From the VPP Applications tab: install the app from there, so it uses your Apple Business Manager licenses. An app installed as a regular App Store app can ask the user.

  • Enough licenses: each iPad uses one license, even for free apps.

If Swif asked for an Apple ID, the app was installed with Install > Selected devices, which licenses it to the device owner. Install it again to a device group instead.


Configure apps automatically, on iPhone and iPad

Managed app configuration sends settings to a VPP app when Swif installs it, so users don't have to set it up. For example, you can send Tailscale an auth key, so it signs in by itself, and name each device after its serial number.

Item

Details

Devices

iPhone and iPad. Not Macs.

Apps

VPP apps on the VPP Applications tab, except Swif Mobile Security, which Swif configures itself

Which settings

Each app decides which settings it accepts, and their names. Check the app's documentation for managed app configuration, sometimes called AppConfig or MDM keys.

Value types

Type

Example

String

Acme Corp

Integer

443

Real

1.5

Boolean

true

Array

A list of values

Dictionary

A group of settings inside a setting

Use the type the app expects. For example, 443 as an Integer isn't the same as "443" as a String.

Device-specific values

Add a placeholder to a text value, and Swif replaces it on each device:

Placeholder

Replaced with

{{SERIAL}}

The device's serial number

{{DEVICEID}}

The device's Swif ID

{{TEAMID}}

Your Swif Team ID

{{MAIL}}

The device owner's email. The device's Swif ID if it has no owner.

{{NAME}}

The device owner's name. The device's Swif ID if it has no owner.

Placeholders work in values only, not in setting names.

Example: Tailscale

Setting

Type

Value

AuthKey

String

Your Tailscale auth key

Hostname

String

acme-{{SERIAL}}

ManagedByOrganizationName

String

Acme Corp

Each iPad signs in to Tailscale, appears as acme- followed by its serial number, and shows that it's managed by Acme Corp. See Tailscale's MDM keys for every setting it accepts.

Keep auth keys secret. Anyone who can see the app's configuration in Swif can see its values. Use a Tailscale key that's limited to what the devices need.

How configuration is delivered

  • New installs get the configuration with the app.

  • When you change it, Swif sends the new configuration to every device that has the app, in the background.

  • Saving replaces the whole configuration. Settings you remove are removed from devices too.

  • Removing all settings clears the configuration from devices.

  • Removing the app from Swif clears its configuration from devices. The app itself stays installed.

Right after an install, a change may not reach a device until Swif sees the app in the device's app list, which it reads about every 8 hours. Later changes are sent right away.

Limits

  • Up to 64 KB, and up to 8 levels of settings inside settings

  • Every setting needs a value

  • Setting names can't be empty, start or end with a space, or contain control characters


Moving from Jamf or another MDM

Apps the previous MDM installed

Swif can't take over VPP apps another MDM installed. They keep working on the device, but Swif doesn't manage or update them. To manage an app with Swif, install it from Swif.

Important: Assign apps in Swif before you move your content token. Whenever a device's app list in Swif changes, Swif releases that device's licenses for every other app in the same Apple Business Manager location, including apps your previous MDM assigned. So before you upload a location's token to Swif, assign every app each device needs in Swif. Otherwise, devices can lose licenses for apps they still use.

iPads moved with OS 26 migration

iPads moved to Swif with Apple's in-place migration, on iPadOS 26 or later, lose the apps the previous MDM installed. Swif finishes setting up the iPad right away, and apps come back only as Swif installs them. Before the migration deadline, assign the apps the iPads need to their device groups in Swif. See Migrate Apple Devices to Swif Without Erasing Them.


Add Managed Apple IDs, for user-based licenses

Only needed if you install to Selected devices. Add each device owner's Managed Apple ID to their employee record in Swif:

  • One at a time: edit the employee, and fill in Managed Apple ID.

  • In bulk: update employees with a CSV file.

If an owner has no Managed Apple ID, Swif asks for it when you install.


App updates

Swif syncs with Apple Business Manager regularly, to get each app's latest version. When a new version is available, Swif updates the app on the devices it's installed on, following the same rules as installing.

To sync right away, use Sync or Force sync on your VPP token in Swif.


Let users install apps themselves

To offer an app, without installing it for everyone, assign it to users' Managed Apple IDs in Apple Business Manager. They find it in the App Store, under Purchased, and install it when they want. Only users who install it use a license.

Apple Business Essentials works similarly: users signed in with a Managed Apple ID see your VPP apps in the App Store, even on devices Swif doesn't manage. Swif can't install or remove apps on devices it doesn't manage.


Troubleshooting

Apps from a previous MDM aren't managed by Swif

Swif can't take over VPP apps another MDM installed. Install the app from Swif to manage it. See Moving from Jamf or another MDM.

A device lost licenses after I moved our content token

When a device's app list in Swif changes, Swif releases its licenses for every other app in the same Apple Business Manager location. Assign every app the device needs in Swif, then sync your VPP token.

A supervised iPad asks the user to install the app

  • Check that the iPad is supervised. Unsupervised iPads always ask.

  • Check that the app came from your VPP token, on the VPP Applications tab. An app installed as a regular App Store app can ask the user.

If it still asks, contact Swif support, and we'll check your setup.

Swif asks for a Managed Apple ID when I install

You chose Selected devices, which uses user-based licenses. To install without a Managed Apple ID, install to a device group instead.

An app didn't get its configuration

  • Check that the device is an iPhone or iPad. Macs don't get managed app configuration.

  • If the app was just installed, the configuration may wait until Swif next reads the device's app list, about every 8 hours.

  • Check the setting names and types against the app's documentation. Apps ignore settings they don't recognize.

An app doesn't sign in by itself

Check the app's documentation for the right setting names, and that the key or token you sent is valid. For Tailscale, see Tailscale's MDM keys.

A device doesn't appear in Selected devices

Selected devices lists only devices whose owner has a Managed Apple ID. Add one to the owner's employee record, or install to a device group.

An app shows "Not installed," but it's on the iPad

Swif reads an iPad's app list about every 8 hours. If the app was installed recently, or by hand, the status updates at the next check.

Installs fail on a Mac

The Mac is probably personal. Apple doesn't allow managed VPP apps on personal Macs. Check the Mac's enrollment type in Swif.

New installs fail for an app

You may be out of licenses. Get more in Apple Business Manager, then sync your VPP token in Swif.

"VPP token invalid," or apps stop syncing

Your content token has expired. Download a new one from Apple Business Manager, and upload it in Swif.


Related resources

Did this answer your question?