---
title: MXDiskSpaceUsageMetric
framework: metrickit
role: symbol
role_heading: Class
path: metrickit/mxdiskspaceusagemetric
---

# MXDiskSpaceUsageMetric

An object representing metrics about your app’s disk space usage.

## Declaration

```swift
class MXDiskSpaceUsageMetric
```

## Overview

Overview This object provides insights on how your app utilizes disk space and related storage technologies, such as cache folders and clone files. Disk space is a limited resource shared by many apps. Optimize your app’s disk space usage to provide a better customer experience. People can inspect your app’s disk footprint in Settings, and excessive usage may force them to remove your app to install new apps or perform system updates. note: MetricKit reports MXDiskSpaceUsageMetric on devices running iOS 26 or later. Disk Space Measurements Modern file systems such APFS provide enhanced features to maximize space utilization, such as file cloning. The disk space usage metric reports size accurately without double counting the cloned files. For example, if you copy a file using copyItem(at:to:), the file system shows two separate files. However, due to the file system optimization, the copied file shares the same storage space with the original file. If you manually calculate the size of all your files, your calculation may also include the copied file, resulting in a larger size than expected. Storing App-Specific Files Use the totalCacheFolderSize property of MXDiskSpaceUsageMetric to gain insights into how the operating system manages your app’s cached content in the field. Placing files in the appropriate directories, such as the cachesDirectory and temporaryDirectory (see File System Basics), allows the system to intelligently manage and purge content when necessary, ensuring optimal disk space utilization and a better user experience.

## Topics

### Reading file counts

- [totalBinaryFileCount](metrickit/mxdiskspaceusagemetric/totalbinaryfilecount.md)
- [totalDataFileCount](metrickit/mxdiskspaceusagemetric/totaldatafilecount.md)

### Reading file sizes

- [totalBinaryFileSize](metrickit/mxdiskspaceusagemetric/totalbinaryfilesize.md)
- [totalCacheFolderSize](metrickit/mxdiskspaceusagemetric/totalcachefoldersize.md)
- [totalCloneSize](metrickit/mxdiskspaceusagemetric/totalclonesize.md)
- [totalDataFileSize](metrickit/mxdiskspaceusagemetric/totaldatafilesize.md)

### Reading disk capacity and space

- [totalDiskSpaceCapacity](metrickit/mxdiskspaceusagemetric/totaldiskspacecapacity.md)
- [totalDiskSpaceUsedSize](metrickit/mxdiskspaceusagemetric/totaldiskspaceusedsize.md)

## Relationships

### Inherits From

- [MXMetric](metrickit/mxmetric.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Disk metrics

- [MXDiskIOMetric](metrickit/mxdiskiometric.md)