<!--
{
  "documentType" : "article",
  "framework" : "Updates",
  "identifier" : "/documentation/Updates/PaperKit",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "PaperKit updates"
}
-->

# PaperKit updates

Learn about important changes to PaperKit.

## Overview

Browse notable changes in <doc://com.apple.documentation/documentation/PaperKit>.

## June 2026

### Data model

- Represent a markup document using <doc://com.apple.documentation/documentation/PaperKit/PaperMarkup>, which provides a background color and an ordered collection of markup elements accessible through the <doc://com.apple.documentation/documentation/PaperKit/Markup> protocol and <doc://com.apple.documentation/documentation/PaperKit/MarkupOrderedSet>.

### Markup elements

- Add images and shapes to a markup document using <doc://com.apple.documentation/documentation/PaperKit/ImageMarkup> and <doc://com.apple.documentation/documentation/PaperKit/ShapeMarkup>, and embed URLs and magnified views using <doc://com.apple.documentation/documentation/PaperKit/LinkMarkup> and <doc://com.apple.documentation/documentation/PaperKit/LoupeMarkup>.
- Control which interactions (such as move, resize, rotate, and delete) are available for each element using <doc://com.apple.documentation/documentation/PaperKit/MarkupInteractions>.

### Adornments

- Attach custom visuals or handles to specific locations on the canvas using <doc://com.apple.documentation/documentation/PaperKit/MarkupAdornment>, and respond to taps and position changes through the <doc://com.apple.documentation/documentation/PaperKit/PaperMarkupViewController> delegate.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)