Grab with Controller Driven Hands

Updated: Nov 3, 2025

Overview

Interaction SDK version compatibility

This tutorial requires Interaction SDK v63 or later. If you are using an earlier version of Interaction SDK, see Create Grab Interactions, which uses the legacy version of the Interaction SDK.

In this Interaction SDK tutorial, you learn how to grab an object using controller-driven hands.

By the end of this guide, you should be able to:

Set up and use the Interaction SDK.

Implement the HandGrabInteractor prefab to perform hand grab interactions using controller-driven hands.

If you need to interact with objects using only hands or controllers, see Add an Interaction with QuickActions.

To try grab interactions in a pre-built scene, see the HandGrabExamples scene.

Prerequisites

Before proceeding with this tutorial, complete the setup steps outlined in Getting Started with Interaction SDK to create a project with the necessary dependencies.

Add hand grab interactors to controller driven hands

Hand grab interactors let you initiate a grab when using controller driven hands.

Open the Unity scene where you set up your controller driven hands.

In the Project window’s search bar, search for HandGrabInteractor. Ensure the search filter is set to either All or In Packages, since the default setting only searches your assets.

Drag the HandGrabInteractor prefab from the search results into the Hierarchy onto OVRControllerDrivenHands > LeftHand > HandInteractorsLeft.

Under Hierarchy, select LeftHand > HandInteractorsLeft.

Under Inspector, in the Best Hover Interactor Group component, click the + to add an element to the Interactors list. This list contains the interactions that the SDK can choose from whenever you hover an object.

Set the element to HandGrabInteractor.

Repeat these steps for the right controller hand.

Learn more

To learn about the fields of the Hand Grab interaction, see Hand Grab Interactions.

To change which fingers start and end a hand grab, see Hand Grab Rules.

To customize how grabbed objects transform, rotate, and scale, see Grabbable.

For the legacy (pre-v62) version of this tutorial, see Create Grab Interactions.

Design guidelines

Hands

Hands design: Learn about design for using hands in your app.

Hands technology: Learn about the technology behind hands.

Hands interaction types: Learn about the different types of hands interactions.

Hands best practices: Learn about the best practices, limitations and mitigations for using hands in your app.

Hand representation: Learn about hand representation.

Core interactions

Input primitives: Learn about the different input primitives.

Input hierarchy: Learn about the different input hierarchies.

Multimodality: Learn about multimodality.

Did you find this page helpful?