---
title: "loadAnchor(named:in:)"
framework: realitykit
role: symbol
role_heading: Type Method
path: "realitykit/entity/loadanchor(named:in:)"
---

# loadAnchor(named:in:)

Synchronously loads an anchor entity from a bundle.

## Declaration

```swift
@MainActor @preconcurrency static func loadAnchor(named name: String, in bundle: Bundle? = nil) throws -> AnchorEntity
```

## Parameters

- `name`: The base name of the file to load, omitting the filename extension.
- `bundle`: The bundle containing the file. Use nil to search the app’s main bundle.

## Mentioned in

Loading entities from a file

## Return Value

Return Value The root entity in the loaded file, which Reality Kit casts as an AnchorEntity.

## Discussion

Discussion Loading an Entity with this method blocks the main actor because it’s synchronous, so only call it from a command-line application. The method can stall a regular app, which makes it visibly hitch, and the system terminates an app if its UI becomes unresponsive. See init(named:in:) for an example that demonstrates how to safely load content.

## See Also

### Loading an anchor entity

- [loadAnchor(contentsOf:withName:)](realitykit/entity/loadanchor(contentsof:withname:).md)
- [loadAnchorAsync(named:in:)](realitykit/entity/loadanchorasync(named:in:).md)
- [loadAnchorAsync(contentsOf:withName:)](realitykit/entity/loadanchorasync(contentsof:withname:).md)