<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/MeshInstanceCollection",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation22MeshInstanceCollectionV"
  },
  "title" : "MeshInstanceCollection"
}
-->

# MeshInstanceCollection

An object that holds a collection of mesh resource instances.

```
struct MeshInstanceCollection
```

## Topics

### Creating a collection

[`init()`](/documentation/RealityKit/MeshInstanceCollection/init())

[`init([MeshResource.Instance])`](/documentation/RealityKit/MeshInstanceCollection/init(_:))

### Using the collection

[`func insert(MeshResource.Instance) -> Bool`](/documentation/RealityKit/MeshInstanceCollection/insert(_:))

Add a new instance to the container. Returns true if added. Returns false if it already exists.

[`func remove(id: String) -> MeshResource.Instance?`](/documentation/RealityKit/MeshInstanceCollection/remove(id:))

Remove an instance by name.

[`func removeAll()`](/documentation/RealityKit/MeshInstanceCollection/removeAll())

Remove all the instances.

[`func update(MeshResource.Instance) -> MeshResource.Instance?`](/documentation/RealityKit/MeshInstanceCollection/update(_:))

Update an existing instance. The old instance is returned.

[`subscript(String) -> MeshResource.Instance?`](/documentation/RealityKit/MeshInstanceCollection/subscript(_:))

Read an instance given its name.

### Instance Properties

[`var count: Int`](/documentation/RealityKit/MeshInstanceCollection/count)

Number of instances.

[`var isEmpty: Bool`](/documentation/RealityKit/MeshInstanceCollection/isEmpty)

True if there are no instances.

## Relationships

### Conforms To

[`Copyable`](/documentation/Swift/Copyable)

[`Collection`](/documentation/Swift/Collection)

[`Sequence`](/documentation/Swift/Sequence)

[`Escapable`](/documentation/Swift/Escapable)

[`ExpressibleByArrayLiteral`](/documentation/Swift/ExpressibleByArrayLiteral)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)