Skip to main content
Semantics is currently only available in Early Access. Runtime support is in development or released as experimental.Have feedback? Join the Early Access community to share your thoughts and help shape the feature.
This page covers enabling semantics in the so your Rive views are accessible to VoiceOver. To learn what semantics are and how to add them to a graphic, see the Semantics editor documentation.

​
Overview

You add semantics to the elements of your graphic in the Rive Editor — roles such as button, checkbox, tab, slider, image, link, list, or dialog, along with their labels, values, states, and actions. At runtime, the reads those semantics from the running state machine and exposes them to VoiceOver as the view’s accessibilityElements, keeping them up to date as the state machine advances.
Semantics are opt‑in. The default mode is .off, so no accessibility elements are created until you enable semantics on the view.
Semantics must be defined in the editor to have any effect. If an element has no semantics, it is not exposed to VoiceOver — regardless of the mode you set. See Feature Support for which runtimes currently support semantics.

​
Availability

Semantics are available in the only (not the ), on every Apple platform the runtime supports except macOS (AppKit):
PlatformSupported
iOS / iPadOS✅
tvOS✅
visionOS✅
Mac Catalyst✅
macOS (AppKit)❌

​
Semantics modes

Semantics are controlled by the Semantics enum, which sets the VoiceOver integration mode for a Rive view:
ModeDescription
.offDefault. Accessibility semantics are disabled. No accessibility elements are created, regardless of VoiceOver state.
.onAccessibility semantics are always active. Elements are created and kept up‑to‑date on every frame.
.automaticAccessibility semantics activate and deactivate automatically based on whether VoiceOver is currently running.
For most apps, prefer .automatic — it keeps the accessibility tree in sync only while VoiceOver is active, avoiding unnecessary work when it isn’t.

​
Usage

Set the semantics mode on the view (UIKit) or with the .semantics(_:) modifier (SwiftUI). 
let rive = try await Rive(...)
let riveView = RiveUIView(rive: rive)
// Enable semantics only while VoiceOver is running
riveView.semantics = .automatic
// Always keep semantics active
riveView.semantics = .on
// Disable semantics (default)
riveView.semantics = .off