Develop

Spatial Anchors Unreal Blueprints Reference

Updated: Apr 14, 2026

These async Blueprint nodes are provided by the OculusXR Anchors module. Each node inherits from UBlueprintAsyncActionBase and appears as a latent node in Blueprint graphs with execution pins for success and failure. For the corresponding C++ API, see the C++ Reference. Additional async anchor nodes exist beyond those documented on this page.

OculusXR Async Create Spatial Anchor

Creates a Spatial Anchor at a specific actor’s transform in Unreal world space. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Create spatial anchor blueprint reference image

Input	Description
Target Actor	The Unreal actor to which the spatial anchor component is attached. If the target actor you specify does not already have a Spatial Anchor component, a component is created for the target anchor automatically.
Anchor Transform	The Unreal world space transform of the anchor being created.

Output	Description
Anchor	The created or found anchor component attached to the Target Actor.
Result	Result code of the call after completion.

OculusXR Async Save Anchors

Saves the spatial anchors associated with the specified Actors. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Input	Description
Target Actors	The Unreal actors with spatial anchor components attached that will be saved.

Output	Description
Anchors	The list of anchor components that were saved during this request.
Result	Result code of the call after completion.

OculusXR Async Discover Anchors

Searches for anchors that match the specified discovery criteria. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Note: Unlike other async anchor nodes, Discover Anchors has three execution pins. The Discovered pin fires each time results are found. The Complete pin fires when discovery finishes with a result code. The Failure pin fires if the operation fails.

Discover anchors blueprint reference image

Input	Description
Discovery Info	A structure that contains an array of discovery filters.

Output	Description
Discovery Result	Array of Discovery Result structures. Each element contains an Anchor Handle and the associated UUID.

OculusXR Async Erase Anchors

Erases the specified anchors. You do not have to supply an entry for each input pin, you can mix and match any association of actors, handles, or UUIDs. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Input	Description
Target Actors	An array of actors which must have attached anchor components which will be erased.
Anchor Handles	An array of anchor handles associated with anchors that will be erased.
Anchor UUIDs	An array of anchor UUIDs associated with anchor data that will be erased. These anchors do not have to be loaded into the current scene.

Output	Description
Anchors	An array of anchor components which represent the anchors that were erased, if provided.
Anchor Handles	An array of anchor handles associated with anchors that were erased, if provided.
Anchor UUIDs	An array of anchor UUIDs associated with anchor data that was erased, if provided.
Result	Result code of the call.

Shares one or more anchors with the specified users. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Input	Description
Target Actors	An array of actors that must have attached anchor components. The anchor data associated with each component is shared to the specified users.
To Share With Ids	An array of strings which represent the User IDs of the share targets.

Output	Description
Shared Anchors	An array of anchor components which represent the anchors that were shared from the provided list of actors.
User Ids	An array of strings which represent the User IDs of the share targets.
Result	Result code of the call after completion.

Shares one or more anchors with the specified groups. This function is asynchronous and the results of the function are available via the complete execution pin, which includes a boolean indicating success or failure.

Share anchors with group blueprint reference image

Input	Description
Group UUIDs	An array of UUIDs, each representing the groups you want to share with.
Anchor Handles	An array of int64’s where each element represents an anchor handle.

Output	Description
Success	True or false depending on whether the function call succeeded or not.
Groups	The groups that were shared with.
Anchor Handles	The anchors that were shared.
Result	Result code of the call after completion.

OculusXR Async Get Shared Anchors

Retrieves anchors that have been shared with the user given a set of UUIDs. This function is asynchronous and the results of the function are available via the success and failure execution pins.

Get shared anchors blueprint reference image

Input	Description
AnchorUUIDs	The list of anchor UUIDs that are associated with shared anchors available in the cloud or on your device.

Output	Description
Shared Anchors	An array of discovery result structures, each containing an anchor handle and UUID, representing the anchors found from the provided list of Anchor UUIDs.
Result	Result code of the call after completion.

OculusXR Get Shared Anchors From Group Async

Retrieves anchors that have been shared with a specific group. This function is asynchronous and the results of the function are available via the complete execution pin, which includes a boolean indicating success or failure.

Get shared anchors from group blueprint reference image

Input	Description
Group UUID	The single group to retrieve anchors from.
Anchor UUIDs	An optional array of anchor UUIDs to filter results. If not provided, all anchors shared with the group are returned.

Output	Description
Success	True or false depending on whether the function call succeeded or not.
Anchors	An array of anchor structures, each containing an anchor handle and UUID.
Result	Result code of the call after completion.