# Placing content on detected planes Detect horizontal surfaces like tables and floors, as well as vertical planes like walls and doors. ## Overview Flat surfaces are an ideal place to position content in an app that uses a Full Space in visionOS. They provide a place for virtual 3D content to live alongside a person’s surroundings. Use plane detection in ARKit to detect these kinds of surfaces and filter the available planes based on criteria your app might need, such as the size of the plane, its proximity to someone, or a required plane orientation.  ### Use RealityKit anchor entities for basic plane anchoring If you don’t need a specific plane in your app and you’re rendering your app’s 3D content in RealityKit, you can use an instead. This approach lets you attach 3D content to a plane without prompting the person for world-sensing permission and without any particular knowledge of where that plane is relative to the person. The following shows an anchor that you can use to attach entities to a table: ```swift AnchorEntity(.plane(.horizontal, classification: .table, minimumBounds: [0.5, 0.5])) ``` Anchor entities don’t let you choose a specific plane in a person’s surroundings, but rather let you ask for a plane with certain characteristics. When you need more specific plane selection or real-time information about the plane’s position and orientation in the world, use `ARKitSession` and `PlaneDetectionProvider`. ### Configure an ARKit session for plane detection Plane-detection information comes from an that’s configured to use a . You can choose to detect horizontal planes, vertical planes, or both. Each plane that ARKit detects comes with a classification, like or . You can use these classifications to further refine which kinds of planes your app uses to present content. Plane detection requires authorization. The following starts a session that detects both horizontal and vertical planes, but filters out planes classified as windows: ```swift let session = ARKitSession() let planeData = PlaneDetectionProvider(alignments: [.horizontal, .vertical]) Task { try await session.run([planeData]) for await update in planeData.anchorUpdates { if update.anchor.classification == .window { // Skip planes that are windows. continue } switch update.event { case .added, .updated: await updatePlane(update.anchor) case .removed: await removePlane(update.anchor) } } } ``` ### Create and update entities associated with each plane If you’re displaying content that needs to appear attached to a particular plane, update your content whenever you receive new information from ARKit. When a plane is no longer available in the person’s surroundings, ARKit sends a removal event. Respond to these events by removing content associated with the plane. The following shows plane updates that place a text entity on each plane in a person’s surroundings; the text entity displays the kind of plane ARKit detected: ```swift @MainActor var planeAnchors: [UUID: PlaneAnchor] = [:] @MainActor var entityMap: [UUID: Entity] = [:] @MainActor func updatePlane(_ anchor: PlaneAnchor) { if planeAnchors[anchor.id] == nil { // Add a new entity to represent this plane. let entity = ModelEntity(mesh: .generateText(anchor.classification.description)) entityMap[anchor.id] = entity rootEntity.addChild(entity) } entityMap[anchor.id]?.transform = Transform(matrix: anchor.originFromAnchorTransform) } @MainActor func removePlane(_ anchor: PlaneAnchor) { entityMap[anchor.id]?.removeFromParent() entityMap.removeValue(forKey: anchor.id) planeAnchors.removeValue(forKey: anchor.id) } ``` --- Copyright © 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)