<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Metal",
  "identifier" : "/documentation/Metal/MTLHeapDescriptor/maxCompatiblePlacementSparsePageSize",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Metal"
    ],
    "preciseIdentifier" : "c:objc(cs)MTLHeapDescriptor(py)maxCompatiblePlacementSparsePageSize"
  },
  "title" : "maxCompatiblePlacementSparsePageSize"
}
-->

# maxCompatiblePlacementSparsePageSize

Specifies the largest sparse page size that the Metal heap supports.

```
var maxCompatiblePlacementSparsePageSize: MTLSparsePageSize { get set }
```

## Discussion

This parameter only affects the heap if you set the [`type`](/documentation/Metal/MTLHeapDescriptor/type) property of this descriptor
to [`MTLHeapType.placement`](/documentation/Metal/MTLHeapType/placement).

The value you assign to this property determines the compatibility of the Metal heap with with placement sparse
resources, because placement sparse resources require that their sparse page size be less than or equal to the
placement sparse page of the Metal heap that this property controls.

---

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)