Develop

Interactable Widgets

Updated: Apr 15, 2026

The AIsdkInteractableWidget is an actor that wraps the UIsdkInteractableWidgetComponent. This component handles the configuration necessary to display a Widget Blueprint in the world and make it interactable using Interaction SDK interactions. If you need widget functionality on an existing actor, you can add the UIsdkInteractableWidgetComponent directly instead of placing the AIsdkInteractableWidget actor.

UI displayed using an Interactable Widget

How do Interactable Widgets work?

Note: The Interaction SDK (OculusInteraction) plugin must be enabled in your project before using Interactable Widgets. See Getting Started with Interaction SDK for Unreal Engine for setup instructions.

The AIsdkInteractableWidget takes a UI built with UMG (Unreal Motion Graphics) using a Widget Blueprint and displays it using a Widget Component. It also adds components for handling poke and ray interactions and pipes the events from those through to the underlying UI. This means you can interact with a native UMG UI just as you would any other interactable object built manually.

Note: Because the Interaction SDK events are passed through to the UI at a low level, you do not have access to those events in the UI itself to know what interacted with the UI or what type of interaction it was.

The Widget Component section in the properties contains settings for configuring the UI itself. You can tell it what Widget Blueprint to display, the size, and specify some additional appearance-related options. The complete list of options is explained below.

Property	Description
Draw Size	Controls the resolution the UI is rendered at. Default: 1000×1000.
Widget Scale	Controls the physical size of the UI in the world. Default: 0.02.
Widget Class	Specifies the Widget Blueprint asset to use for the UI.
Pivot	Controls the pivot point of the widget as a normalized coordinate (FVector2D). Default: 0.5, 0.5.
Use Rounded Box Material	If enabled, a specialized material with rounded corners is used for the backplate of the UI. The Corner Radius, Background Color, Blend Mode, and Two Sided properties are only editable when this is enabled.
Corner Radius	Determines the radius of the corners of the backplate when using the rounded box material. Supports individual values per corner (FVector4).
Background Color	Sets the color of the backplate when using the rounded box material (FLinearColor).
Blend Mode	Determines the blending mode used for the backplate. Available options are: Masked (opacity is either 0.0 or 1.0), Transparent (opacity is a gradient from 0.0 to 1.0).
Two Sided	If enabled, the back side of the UI will be rendered so the UI is visible from behind.

Interactable

The Interactable section in the properties contains settings for configuring what type of interactions the UI will respond to, and, in the case of poke interactions, it provides configuration settings for determining how the interaction will behave.

Property	Description
Create Poke Interactable	If enabled, the components necessary to make the UI interactable using poke interactions are added. Default: enabled.
Default Poke Interactable Config Asset	Specifies the Data Asset to use for the config settings.
Normal Offset	An offset added to the EnterHoverNormal, ExitHoverNormal, and CancelSelectNormal settings in the config asset.
Tangent Offset	An offset added to the EnterHoverTangent, ExitHoverTangent, and CancelSelectTangent settings in the config asset.
Create Ray Interactable	If enabled, the components necessary to make the UI interactable using ray casting are added. Default: enabled.

Audio

You can play sounds when the user interacts with the UI using either poke or ray casting. There are two UAudioComponent instances on the AIsdkInteractableWidget:

Selected Hovered Audio - Sound played when the user selects and the selection hits an interactive UI element.

Selected Empty Audio - Sound played when the user selects but the selection does not hit an interactive UI element.

Learn more

To learn more about using Interactable Widgets and related interaction features, see the following guides:

Getting Started with Interaction SDK for Unreal Engine

Poke Interactions

Ray Interactions

Pointer Events in Interaction SDK

Pointer Event Audio Player

Interaction SDK Best Practices

Design guidelines

Design guidelines are Meta’s human interface standards and design frameworks that help you create safe, user-oriented, and retainable immersive and passthrough user experiences.