Files
apple_device-management/mdm/profiles/com.apple.font.yaml
T
2026-06-22 15:55:19 -04:00

66 lines
2.5 KiB
YAML

title: Font
description: The payload that configures fonts.
payload:
payloadtype: com.apple.font
supportedOS:
iOS:
introduced: '7.0'
multiple: true
supervised: false
allowmanualinstall: true
sharedipad:
mode: allowed
devicechannel: false
userchannel: true
userenrollment:
mode: allowed
macOS:
introduced: '10.9'
multiple: true
devicechannel: true
userchannel: true
supervised: false
requiresdep: false
userapprovedmdm: false
allowmanualinstall: true
userenrollment:
mode: allowed
tvOS:
introduced: n/a
visionOS:
introduced: '2.0'
multiple: true
supervised: false
allowmanualinstall: true
userenrollment:
mode: allowed
watchOS:
introduced: n/a
content: |-
Each payload may contain one font file. Font files may be in TrueType (.ttf) or OpenType (.otf) file format. Collection types (.ttc or .otc) formats are not supported.
Fonts are uniquely identified internally by their embedded PostScript name. Two fonts with the same PostScript name will be considered the same font, even if their contents differ. Installing two different fonts with the same PostScript name is not supported, and it is undefined which font will remain installed.
Supported on the Shared iPad user channel as of iPadOS 18.0. Earlier versions of iPadOS erroneously accepted the Font payload on the device channel but installed it for the currently logged in user.
payloadkeys:
- key: Name
title: Font name
type: <string>
presence: optional
default: ''
content: |-
The user-visible name for the font. The device replaces this field with the actual name of the font after installation. Each payload must contain exactly one font file in trueType (.ttf) or OpenType (.otf) format. The device doesn't support collection formats (.ttc or .otc).
The device identifies fonts by their embedded PostScript names. The device considers two fonts with the same PostScript name to be the same font, even if their contents differ. The device doesn't support installing two different fonts with the same PostScript name, and the resulting behavior is undefined.
- key: Font
title: Font
type: <data>
presence: required
content: The contents of the font file.
notes:
- title: ''
content: In iPadOS 18 and later, the font profile is available on the user channel
for Shared iPad.
examples:
- title: Profile example
files:
- file: examples/mdm/profiles/com.apple.font/example1.plist