---
title: "addResidencySet(_:)"
framework: metal
role: symbol
role_heading: Instance Method
path: "metal/mtlcommandqueue/addresidencyset(_:)"
---

# addResidencySet(_:)

Applies a residency set to a queue, which Metal applies to the queue’s command buffers as you commit them.

## Declaration

```swift
func addResidencySet(_ residencySet: any MTLResidencySet)
```

## Parameters

- `residencySet`: A residency set that contains resource allocations, such as doc://com.apple.metal/documentation/Metal/MTLBuffer, doc://com.apple.metal/documentation/Metal/MTLTexture, and doc://com.apple.metal/documentation/Metal/MTLHeap instances.

## Mentioned in

Simplifying GPU resource management with residency sets

## Discussion

Discussion Each command queue can maintain a list of up to 32 different residency sets. See Simplifying GPU resource management with residency sets and MTLResidencySet for more information.

## See Also

### Attaching residency sets

- [addResidencySets(_:)](metal/mtlcommandqueue/addresidencysets(_:).md)