Skip to content

Rename Apple Business Manager in articles - #42579

Merged
rachaelshaw merged 20 commits into
docs-v4.84.0from
melpike-rename-abm-articles
Apr 17, 2026
Merged

Rename Apple Business Manager in articles#42579
rachaelshaw merged 20 commits into
docs-v4.84.0from
melpike-rename-abm-articles

Conversation

@melpike

@melpike melpike commented Mar 27, 2026

Copy link
Copy Markdown
Member

Related issue: Resolves #42575

@melpike

melpike commented Mar 27, 2026

Copy link
Copy Markdown
Member Author

Note: keeping this in draft until the Apple Business release from Apple on April 14th.

@melpike
melpike changed the base branch from main to docs-v4.84.0 March 30, 2026 16:49
Updated references from 'Management Assignment' to 'Default Device Assignment' in Apple Business instructions. Adjusted links to point to the correct Apple documentation.
Updated link to Apple's documentation for purchasing apps.

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

Tip: disable this comment in your organization's Code Review settings.

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

Review Summary by Qodo

Rename Apple Business Manager to Apple Business across documentation and product references

📝 Documentation

Grey Divider

Walkthroughs

Description
• Comprehensive rename of Apple Business Manager (ABM) to Apple Business (AB) across 50+
  documentation files, articles, and configuration references
• Updated product terminology in marketing assets, API documentation, configuration guides, and
  handbook entries
• Restructured Apple MDM setup guide with clearer step-by-step instructions for APNs setup, Apple
  Business connection, and VPP token management
• Simplified troubleshooting sections by removing detailed workflow diagrams and consolidating
  enrollment guidance
• Updated job position requirements and IT handbook references to reflect new Apple Business naming
  convention
• Modified server configuration documentation and contributor reference guides to use new
  terminology
• Updated website marketing copy and device management page descriptions with new product naming
Diagram
flowchart LR
  ABM["Apple Business Manager<br/>ABM"]
  AB["Apple Business<br/>AB"]
  Docs["Documentation Files<br/>50+ articles"]
  Config["Configuration &<br/>API Docs"]
  Marketing["Marketing Assets<br/>& Handbook"]
  
  ABM -- "rename" --> AB
  AB -- "update" --> Docs
  AB -- "update" --> Config
  AB -- "update" --> Marketing
Loading

Grey Divider

File Changes

1. docs/solutions/macos/scripts/revoke-vpp-licenses.sh 📝 Documentation +2/-2

Rename Apple Business Manager to Apple Business in script

• Updated references from Apple Business Manager (ABM) to Apple Business (AB) in comments
• Changed terminology in two comment lines describing VPP token download and license revocation
 reflection

docs/solutions/macos/scripts/revoke-vpp-licenses.sh


2. articles/apple-mdm-setup.md 📝 Documentation +74/-72

Rename ABM to Apple Business and restructure MDM setup guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) throughout the article
• Restructured APNs setup instructions with clearer step-by-step guidance for connecting, renewing,
 and managing certificates
• Reorganized AB section with updated instructions for connecting Fleet to AB, managing tokens, and
 configuring device assignments
• Simplified troubleshooting section by removing detailed ABM workflow diagrams and consolidating
 failed enrollment guidance
• Updated VPP token management instructions with new Apple Business interface references

articles/apple-mdm-setup.md


3. articles/what-is-apple-business-manager-a-complete-guide.md 📝 Documentation +42/-42

Rename Apple Business Manager to Apple Business throughout

• Renamed all instances of Apple Business Manager (ABM) to Apple Business (AB) throughout the
 article
• Updated section headings and descriptions to reflect the new terminology
• Changed references in metadata and article title from ABM to AB

articles/what-is-apple-business-manager-a-complete-guide.md


View more (44)
4. articles/mac-zero-touch-deployment-guide.md 📝 Documentation +15/-15

Rename ABM to Apple Business in zero-touch deployment guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in multiple sections
• Updated references in architecture descriptions, prerequisites, and API capabilities sections
• Changed terminology in comparison table and FAQ sections

articles/mac-zero-touch-deployment-guide.md


5. articles/what-is-apple-mdm.md 📝 Documentation +13/-13

Rename Apple Business Manager to Apple Business in MDM guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) throughout the article
• Updated section headings and descriptions referencing ABM/AB
• Changed terminology in FAQ section comparing MDM and AB

articles/what-is-apple-mdm.md


6. articles/managing-macs-globally-apple-ecosystem-deployment-security.md 📝 Documentation +12/-12

Rename ABM to Apple Business in global Mac management guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) throughout the article
• Updated section headings and descriptions in architecture and deployment sections
• Changed terminology in FAQ and best practices sections

articles/managing-macs-globally-apple-ecosystem-deployment-security.md


7. articles/enroll-personal-byod-ios-ipad-hosts-with-managed-apple-account.md 📝 Documentation +13/-13

Rename ABM to Apple Business in BYOD enrollment guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in step titles and instructions
• Updated Apple documentation links to reflect new Apple Business interface
• Added note about outdated video references showing old ABM interface
• Changed terminology in step descriptions and navigation paths

articles/enroll-personal-byod-ios-ipad-hosts-with-managed-apple-account.md


8. articles/enroll-macbook-neo-at-scale-with-fleet-zero-touch.md 📝 Documentation +11/-11

Rename Apple Business Manager to Apple Business in MacBook Neo guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in multiple sections
• Updated references in zero-touch enrollment workflow description
• Changed terminology in checklist and configuration sections
• Updated metadata description to reference AB instead of ABM

articles/enroll-macbook-neo-at-scale-with-fleet-zero-touch.md


9. articles/mdm-migration.md 📝 Documentation +10/-10

Rename ABM to Apple Business in MDM migration guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in requirements and step
 descriptions
• Updated instructions for assigning/unassigning hosts in AB with new interface references
• Changed terminology in workflow descriptions and notes
• Updated Activation Lock management references to AB

articles/mdm-migration.md


10. articles/fleet-vs-jamf-pro-ninjaone-mdm-comparison.md 📝 Documentation +6/-6

Rename Apple Business Manager to Apple Business in MDM comparison

• Renamed Apple Business Manager to Apple Business in overview and comparison sections
• Updated references in enrollment, provisioning, and software deployment sections
• Changed terminology in FAQ section

articles/fleet-vs-jamf-pro-ninjaone-mdm-comparison.md


11. handbook/marketing/marketing-assets.md 📝 Documentation +3/-3

Update marketing assets with Apple Business terminology

• Updated article title from What is Apple Business Manager? A complete guide to `What is Apple
 Business? A complete guide`
• Changed description from ABM to AB terminology
• Updated reference in editorial section from ABM campaigns to AB campaigns

handbook/marketing/marketing-assets.md


12. articles/mac-inventory-management.md 📝 Documentation +6/-6

Rename Apple Business Manager to Apple Business in inventory guide

• Renamed Apple Business Manager to Apple Business in enrollment and implementation sections
• Updated references in best practices and FAQ sections
• Changed terminology in tool evaluation guidance

articles/mac-inventory-management.md


13. articles/apple-device-enrollment-program.md 📝 Documentation +4/-4

Rename ABM to Apple Business in ADE guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in overview and prerequisites
 sections
• Updated references in ADE setup and configuration sections
• Changed terminology in MDM vendor evaluation guidance

articles/apple-device-enrollment-program.md


14. articles/ipad-mdm-a-complete-guide.md 📝 Documentation +6/-6

Rename Apple Business Manager to Apple Business in iPad MDM guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in enrollment and supervision
 sections
• Updated references in integration and MDM evaluation sections
• Changed terminology in capabilities and considerations sections

articles/ipad-mdm-a-complete-guide.md


15. articles/setup-experience.md 📝 Documentation +5/-5

Rename ABM to Apple Business in setup experience guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in introduction and testing
 sections
• Updated references in software installation and Setup Assistant customization sections
• Changed terminology in notes and guidance

articles/setup-experience.md


16. docs/Contributing/reference/api-for-contributors.md 📝 Documentation +11/-11

Rename Apple Business Manager to Apple Business in API documentation

• Renamed Apple Business Manager to Apple Business in endpoint descriptions and section headings
• Updated parameter descriptions to reference AB instead of ABM
• Changed terminology in API documentation for token management endpoints

docs/Contributing/reference/api-for-contributors.md


17. articles/apple-push-notification-service-apns-mdm.md 📝 Documentation +3/-3

Rename Apple Business Manager to Apple Business in APNs guide

• Renamed Apple Business Manager to Apple Business in feature descriptions and integration
 sections
• Updated references in MDM functions and Fleet integration sections

articles/apple-push-notification-service-apns-mdm.md


18. articles/mdm-providers-compared.md 📝 Documentation +3/-3

Rename Apple Business Manager to Apple Business in provider comparison

• Renamed Apple Business Manager to Apple Business in enrollment and deployment sections
• Updated references in FAQ and comparison sections

articles/mdm-providers-compared.md


19. articles/fleet-supports-macos-26-tahoe-ios-26-and-ipados-26.md 📝 Documentation +3/-3

Rename ABM to Apple Business in macOS 26 support article

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in feature descriptions and
 migration guidance
• Updated references in section headings and notes

articles/fleet-supports-macos-26-tahoe-ios-26-and-ipados-26.md


20. docs/Contributing/architecture/mdm/automated-device-enrollment.md 📝 Documentation +5/-5

Rename Apple Business Manager to Apple Business in ADE architecture

• Renamed Apple Business Manager/Apple School Manager to Apple Business/Apple School Manager in
 architecture overview
• Updated references in key components and synchronization process sections
• Changed terminology in special case descriptions

docs/Contributing/architecture/mdm/automated-device-enrollment.md


21. handbook/company/open-positions.yml 📝 Documentation +1/-1

Update job position requirements with Apple Business terminology

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in job experience requirements

handbook/company/open-positions.yml


22. articles/automated-provisioning-for-Linux-desktop-in-the-enterprise.md 📝 Documentation +1/-1

Rename Apple Business Manager to Apple Business in Linux provisioning guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in best practices section

articles/automated-provisioning-for-Linux-desktop-in-the-enterprise.md


23. articles/how-to-manage-company-laptops-a-complete-guide.md 📝 Documentation +2/-2

Rename Apple Business Manager to Apple Business

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in two locations
• Updated references to reflect the new product naming convention

articles/how-to-manage-company-laptops-a-complete-guide.md


24. articles/fleet-management-software.md 📝 Documentation +3/-3

Update Apple Business Manager naming in fleet comparison

• Replaced Apple Business Manager with Apple Business in enrollment section
• Updated abbreviations from ABM to AB in multiple references
• Maintained consistency across product naming in comparison content

articles/fleet-management-software.md


25. articles/6-business-benefits-of-apple-mdm-explained.md 📝 Documentation +2/-2

Rename Apple Business Manager throughout MDM benefits article

• Changed Apple Business Manager to Apple Business in introduction and getting started sections
• Updated abbreviation from ABM / ASM to AB / ASM
• Renamed integration references from Apple Business Manager to Apple Business

articles/6-business-benefits-of-apple-mdm-explained.md


26. articles/end-user-authentication.md 📝 Documentation +4/-4

Update Apple Business Manager naming in authentication guide

• Renamed section heading from What is Apple Business Manager? to What is Apple Business?
• Updated product name from Apple Business Manager (ABM) to Apple Business (AB) in prerequisites
• Changed references in ADE vs DEP section to use new naming

articles/end-user-authentication.md


27. articles/fleet-now-supports-ios-and-ipados-software-deployment-and-automated-patch-management.md 📝 Documentation +2/-2

Rename Apple Business Manager in iOS/iPadOS deployment article

• Updated section heading from Multiple Apple Business Manager and VPP support to `Multiple Apple
 Business and VPP support`
• Changed Apple Business Manager (ABM) to Apple Business (AB) in feature description

articles/fleet-now-supports-ios-and-ipados-software-deployment-and-automated-patch-management.md


28. articles/mdm-just-got-better.md 📝 Documentation +3/-3

Update Apple Business Manager naming in MDM improvements article

• Replaced Apple Business Manager with Apple Business in managed device migration section
• Updated references in feature introduction and provisioning context

articles/mdm-just-got-better.md


29. docs/Configuration/fleet-server-configuration.md 📝 Documentation +2/-2

Update Apple Business Manager naming in server configuration docs

• Changed Apple Business Manager (ABM) to Apple Business (AB) in deprecation notice
• Updated token reference from ABM token to AB token
• Modified configuration documentation to reflect new naming

docs/Configuration/fleet-server-configuration.md


30. articles/tales-from-fleet-security-securing-the-startup.md 📝 Documentation +1/-1

Rename Apple Business Manager in startup security article

• Renamed Apple Business Manager to Apple Business in ADE enrollment section
• Updated reference in context of international device ordering

articles/tales-from-fleet-security-securing-the-startup.md


31. handbook/it/README.md 📝 Documentation +1/-1

Update Apple Business Manager naming in IT handbook

• Changed Apple Business Manager (ABM) to Apple Business (AB) in device ordering instructions
• Updated reference in context of eCommerce Portal purchasing workflow

handbook/it/README.md


32. docs/Contributing/reference/configuration-for-contributors.md 📝 Documentation +3/-3

Rename Apple Business Manager in contributor configuration reference

• Updated three configuration option descriptions to use Apple Business instead of `Apple Business
 Manager`
• Changed references in mdm.apple_bm_server_token_bytes, mdm.apple_bm_cert_bytes, and
 mdm.apple_bm_key_bytes sections

docs/Contributing/reference/configuration-for-contributors.md


33. articles/automatic-software-install-in-fleet.md 📝 Documentation +1/-1

Update Apple Business Manager naming in software install article

• Changed Apple Business Manager to Apple Business in VPP app installation troubleshooting
 section
• Updated context for license purchasing reference

articles/automatic-software-install-in-fleet.md


34. articles/enroll-hosts.md 📝 Documentation +1/-1

Rename Apple Business Manager in host enrollment guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in automatic enrollment section
• Updated link text and reference for connecting to Apple services

articles/enroll-hosts.md


35. website/views/pages/device-management.ejs 📝 Documentation +1/-1

Update Apple Business Manager naming in device management page

• Changed Apple Business Manager to Apple Business in automated enrollment feature description
• Updated marketing copy for device drop-shipping capabilities

website/views/pages/device-management.ejs


36. articles/lock-wipe-hosts.md 📝 Documentation +1/-1

Update Apple Business Manager naming in lock/wipe hosts guide

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in host release instructions
• Updated reference in context of preventing automatic re-enrollment

articles/lock-wipe-hosts.md


37. articles/sysadmin-diaries-device-enrollment.md 📝 Documentation +1/-1

Rename Apple Business Manager in sysadmin enrollment article

• Changed Apple Business Manager (ABM) to Apple Business (AB) in BYOD enrollment section
• Updated reference in context of device registration verification

articles/sysadmin-diaries-device-enrollment.md


38. handbook/it/security.md 📝 Documentation +3/-3

Rename Apple Business Manager in security handbook

• Updated section heading from 3 - Observers can access ABM keys to `3 - Observers can access AB
 keys`
• Changed Apple business manager (BM) to Apple Business (BM) in permissions description
• Updated references from ABM/Fleet to AB/Fleet and ABM instance to AB instance

handbook/it/security.md


39. articles/install-app-store-apps.md 📝 Documentation +1/-1

Update Apple Business Manager naming in App Store apps guide

• Changed Apple Business Manager (ABM) to Apple Business (AB) in VPP app purchase instructions
• Updated documentation link reference to Apple's business resources

articles/install-app-store-apps.md


40. articles/technology-platform.md 📝 Documentation +3/-3

Rename Apple Business Manager in technology platform article

• Renamed Apple Business Manager integration to Apple Business integration in requirements
 section
• Updated references in integration description and provisioning context

articles/technology-platform.md


41. articles/role-based-access.md 📝 Documentation +1/-1

Update Apple Business Manager naming in role-based access table

• Changed table entry from Apple Business Manager (ABM) connections to `Apple Business (AB)
 connections`
• Updated permissions documentation for MDM integration management

articles/role-based-access.md


42. articles/the-mdm-mirgration-reality.md 📝 Documentation +1/-1

Rename Apple Business Manager in MDM migration article

• Renamed Apple Business Manager (ABM) to Apple Business (AB) in introduction
• Updated reference in context of MDM migration improvements

articles/the-mdm-mirgration-reality.md


43. articles/debunk-the-cross-platform-myth.md 📝 Documentation +1/-1

Update Apple Business Manager naming in cross-platform article

• Changed Apple Business Manager to Apple Business in automated enrollment section
• Updated reference in context of cross-platform device management

articles/debunk-the-cross-platform-myth.md


44. articles/gitops-mode-software.md 📝 Documentation +1/-1

Update Apple Business Manager naming in GitOps software article

• Renamed Apple Business Manager to Apple Business in App Store apps section
• Updated reference in context of VPP app management via GitOps

articles/gitops-mode-software.md


45. docs/Contributing/product-groups/mdm/custom-configuration-web-url.md 📝 Documentation +1/-1

Rename Apple Business Manager in custom configuration guide

• Changed Apple Business manager to Apple Business in Fleet UI navigation instructions
• Updated reference in context of automatic enrollment configuration

docs/Contributing/product-groups/mdm/custom-configuration-web-url.md


46. articles/what-is-application-management.md 📝 Documentation +1/-1

Update Apple Business Manager naming in application management article

• Changed Apple Business Manager integration to Apple Business integration in platform
 comparison
• Updated reference in context of Jamf Pro capabilities

articles/what-is-application-management.md


47. articles/mac-device-security.md 📝 Documentation +1/-1

Update Apple Business Manager naming in Mac security article

• Renamed Apple Business Manager to Apple Business in MDM selection checklist
• Updated reference in context of zero-touch enrollment capabilities

articles/mac-device-security.md


Grey Divider

Qodo Logo

@qodo-free-for-open-source-projects

qodo-free-for-open-source-projects Bot commented Apr 15, 2026

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (4)   📘 Rule violations (0)   📎 Requirement gaps (0)
🐞\ ≡ Correctness (3) ⚙ Maintainability (1)

Grey Divider


Action required

1. Guide labels don’t match UI 🐞
Description
articles/apple-mdm-setup.md instructs users to click “Add AB” under “Apple Business (AB)”, but the
Fleet UI still uses “ABM” (e.g., “Add ABM”), so users following the guide won’t find the referenced
controls.
Code

articles/apple-mdm-setup.md[R43-45]

+1. In Fleet, navigate to the **Settings > Integrations > MDM** page.
+2. Under **Apple Business (AB)**, select **Add AB**.
+3. Select **Download public key** to download a public key for AB.
Evidence
The guide’s step text references “Add AB”, while the UI page and related components still render
“Add ABM” and “Apple Business Manager”, creating a direct mismatch between documentation and product
UI.

articles/apple-mdm-setup.md[41-46]
frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/AppleBusinessManagerPage.tsx[39-46]
frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/components/AddAbmModal/AddAbmModal.tsx[56-80]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The Apple MDM setup guide uses new labels (“AB”, “Add AB”) that don’t exist in the Fleet UI, which still uses ABM terminology.

### Issue Context
This is a setup guide; mismatched labels are highly likely to cause user confusion and failed setup attempts.

### Fix Focus Areas
- articles/apple-mdm-setup.md[41-51]
- frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/AppleBusinessManagerPage.tsx[39-46]
- frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/components/AddAbmModal/AddAbmModal.tsx[56-80]

### Suggested fix
Choose one consistent naming scheme and apply it across docs and UI.
- If UI is not being renamed in this PR, revert the guide wording to match the UI (“Apple Business Manager (ABM)”, “Add ABM”, etc.).
- If renaming is intended, update UI strings/components accordingly in the same PR (or ensure a coordinated follow-up before publishing the docs).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools



Remediation recommended

2. Broken MDM API TOC links 🐞
Description
In docs/Contributing/reference/api-for-contributors.md, the MDM TOC still links to old fragments
(e.g., #generate-apple-business-manager-public-key-ade and #count-abm-tokens) after section headings
were renamed, so TOC navigation won’t jump to the intended sections.
Code

docs/Contributing/reference/api-for-contributors.md[R552-555]

+- [Generate Apple Business public key (ADE)](#generate-apple-business-manager-public-key-ade)
- [Request Certificate Signing Request (CSR)](#request-certificate-signing-request-csr)
- [Upload APNS certificate](#upload-apns-certificate)
- [Add ABM token](#add-abm-token)
Evidence
The TOC points to fragments containing “manager”/“abm”, but the actual headings were renamed (and
their generated slugs would no longer match), so the TOC fragment targets are stale.

docs/Contributing/reference/api-for-contributors.md[552-560]
docs/Contributing/reference/api-for-contributors.md[589-592]
docs/Contributing/reference/api-for-contributors.md[716-721]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The MDM section’s table-of-contents links use outdated fragment identifiers that no longer match the renamed headings.

### Issue Context
This breaks in-page navigation for readers of the API reference.

### Fix Focus Areas
- docs/Contributing/reference/api-for-contributors.md[552-560]
- docs/Contributing/reference/api-for-contributors.md[589-592]
- docs/Contributing/reference/api-for-contributors.md[716-721]

### Suggested fix
Update the TOC links to match the new heading slugs (e.g., `#generate-apple-business-public-key-ade`, `#count-ab-tokens`) and ensure any other renamed sections have matching TOC entries.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


3. Broken guide fragment link 🐞
Description
articles/apple-mdm-setup.md renames the “Apple Business Manager (ABM)” section header to “Apple
Business (AB)”, but other docs still link to the old #apple-business-manager-abm fragment on that
guide URL, creating dead fragment links.
Code

articles/apple-mdm-setup.md[37]

+## Apple Business (AB)
Evidence
The Apple MDM setup guide’s heading text changed, which changes the generated fragment id; the
handbook still links to the old fragment for the same guide URL, so that link won’t resolve to the
section anymore.

articles/apple-mdm-setup.md[37-41]
handbook/company/product-maturity-assessment.md[34-37]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The Apple MDM setup guide section anchor changed, but existing links still point to the old fragment.

### Issue Context
At least one handbook page links to `.../guides/apple-mdm-setup#apple-business-manager-abm`, which no longer matches the guide’s section heading.

### Fix Focus Areas
- articles/apple-mdm-setup.md[37-41]
- handbook/company/product-maturity-assessment.md[34-37]

### Suggested fix
Either:
1) Update inbound links to the new fragment (likely `#apple-business-ab`), OR
2) Preserve backward compatibility by adding an explicit anchor id near the heading (e.g., an HTML `<a id="apple-business-manager-abm"></a>` just above the new heading).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


4. APNs typo and step gaps 🐞
Description
articles/apple-mdm-setup.md contains a duplicated “APNs” word and multiple ordered-list numbering
gaps (e.g., 3→5 and 5→7), producing confusing instructions and potentially odd rendering depending
on the markdown renderer.
Code

articles/apple-mdm-setup.md[R11-35]

+Apple uses Apple Push Notification service (APNs) APNs to authenticate and manage interactions between Fleet and hosts.

> Apple requires that APNs certificates are renewed annually.
> - The recommended approach is to use a shared admin account to generate the CSR ensuring it can be renewed regardless of individual availability.
-> - If your certificate expires, you must turn MDM off and back on for all macOS hosts. Until then, configuration profile changes and other MDM commands will remain stuck in “Pending.”
-> - Be sure to use the same Apple ID from year-to-year. If you don't, you will have to turn MDM off and back on for all macOS hosts.
+> - If your certificate expires, you must turn MDM off and back on for all Apple hosts. Until then, configuration profile changes and other MDM commands will remain stuck in “Pending.”
+> - Be sure to use the same Apple Account from year-to-year. If you don't, you will have to turn MDM off and back on for all Apple hosts.

-## Apple Business Manager (ABM)
+How to connect Fleet to APNs:

-> Available in Fleet Premium
+1. In Fleet, navigate to the **Settings > Integrations > MDM** page.
+2. Select **Turn on** for Apple (macOS, iOS, iPadOS) MDM.
+3. Select **Download CSR** to download a certificate signing request (CSR) for Apple Push Notification service (APNs).
+4. Sign in to [Apple Push Certificates Portal](https://identity.apple.com/pushcert/). If you don't have an Apple Account, create one.
+5. In Apple Push Certificates Portal, select **Create a Certificate**, upload your CSR, and download your APNs certificate.
+6. Upload APNs certificate (.pem file) in Fleet.
+
+### Renew APNs

-Connect Fleet to your ABM to allow automatic enrollment for company-owned and [Account-driven User Enrollment](https://fleetdm.com/guides/enroll-personal-byod-ios-ipad-hosts-with-managed-apple-account) for personal (BYOD) macOS, iOS, and iPadOS hosts.
+1. In Fleet, navigate to the **Settings > Integrations > MDM** page.
+2. Select **Edit** next to **Apple MDM turned on**.
+3. Select **Renew certificate** and then select **Download CSR** to download a certificate signing request (CSR) for Apple Push Notification service (APNs).
+5. Sign in to [Apple Push Certificates Portal](https://identity.apple.com/pushcert/).
+6. In Apple Push Certificates Portal, select **Renew** next to your certificate. Make sure that the certificate's **Common Name (CN)** matches the one presented in Fleet. If you choose a different certificate, you must turn MDM off and back on for all Apple hosts.
+7. Upload your CSR and download new APNs certificate.
+8. Upload APNs certificate (.pem file) in Fleet.
Evidence
The guide text includes an obvious duplication (“APNs) APNs”) and the ordered lists skip numbers in
multiple places, reducing readability and increasing the risk readers miss steps.

articles/apple-mdm-setup.md[11-16]
articles/apple-mdm-setup.md[27-35]
articles/apple-mdm-setup.md[43-51]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
The Apple MDM setup guide has a duplicated word and non-sequential step numbering.

### Issue Context
This is user-facing setup content; clarity and accurate step ordering matters.

### Fix Focus Areas
- articles/apple-mdm-setup.md[11-16]
- articles/apple-mdm-setup.md[27-35]
- articles/apple-mdm-setup.md[43-51]

### Suggested fix
- Change `... (APNs) APNs ...` to a single `APNs`.
- Renumber the ordered lists so steps are sequential (add the missing step numbers and ensure no steps were accidentally removed).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

ⓘ The new review experience is currently in Beta. Learn more

Grey Divider

Qodo Logo

Comment on lines +43 to +45
1. In Fleet, navigate to the **Settings > Integrations > MDM** page.
2. Under **Apple Business (AB)**, select **Add AB**.
3. Select **Download public key** to download a public key for AB.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Action required

1. Guide labels don’t match ui 🐞 Bug ≡ Correctness

articles/apple-mdm-setup.md instructs users to click “Add AB” under “Apple Business (AB)”, but the
Fleet UI still uses “ABM” (e.g., “Add ABM”), so users following the guide won’t find the referenced
controls.
Agent Prompt
### Issue description
The Apple MDM setup guide uses new labels (“AB”, “Add AB”) that don’t exist in the Fleet UI, which still uses ABM terminology.

### Issue Context
This is a setup guide; mismatched labels are highly likely to cause user confusion and failed setup attempts.

### Fix Focus Areas
- articles/apple-mdm-setup.md[41-51]
- frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/AppleBusinessManagerPage.tsx[39-46]
- frontend/pages/admin/IntegrationsPage/cards/MdmSettings/AppleBusinessManagerPage/components/AddAbmModal/AddAbmModal.tsx[56-80]

### Suggested fix
Choose one consistent naming scheme and apply it across docs and UI.
- If UI is not being renamed in this PR, revert the guide wording to match the UI (“Apple Business Manager (ABM)”, “Add ABM”, etc.).
- If renaming is intended, update UI strings/components accordingly in the same PR (or ensure a coordinated follow-up before publishing the docs).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The UI mismatch it's calling out here actually is addressed already in #42512

@JordanMontgomery JordanMontgomery left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did a quick pass and found a few things

Comment thread handbook/it/security.md Outdated
Comment thread articles/what-is-apple-business-manager-a-complete-guide.md
Comment thread articles/what-is-apple-business-manager-a-complete-guide.md Outdated
Co-authored-by: Jordan Montgomery <elijah.jordan.montgomery@gmail.com>
…to what-is-apple-business-a-complete-guide.md
Comment thread articles/apple-mdm-setup.md Outdated
Comment thread articles/apple-mdm-setup.md Outdated
@rachaelshaw
rachaelshaw merged commit 09ff2ab into docs-v4.84.0 Apr 17, 2026
6 checks passed
@rachaelshaw
rachaelshaw deleted the melpike-rename-abm-articles branch April 17, 2026 18:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename Apple Business Manager (ABM) to Apple Business (AB) in articles/docs/handbook

5 participants