<!--
{
  "availability" : [
    "macOS: 12.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FileProvider",
  "identifier" : "/documentation/FileProvider/NSFileProviderPartialContentFetching",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "File Provider"
    ],
    "preciseIdentifier" : "c:objc(pl)NSFileProviderPartialContentFetching"
  },
  "title" : "NSFileProviderPartialContentFetching"
}
-->

# NSFileProviderPartialContentFetching

Support for fetching part of a file’s content.

```
protocol NSFileProviderPartialContentFetching : NSObjectProtocol
```

## Overview

Adopt this protocol to let the system request only part of a file. Apps that read files provided by your extension can benefit from this feature, either by minimizing the amount of data your file provider needs to download, or by finishing the download quickly, freeing up the reading process.

> Important:
> To trigger a partial download, an app must use POSIX read operations to read part of the file. If you clone the entire file, or read the file using file coordination, the system requests the entire file.

For example, a photo app could read just the metadata from each picture in a large album, without having to completely download all the images. Alternatively, a video streaming app could begin playing the video before reading the whole file, reading chunks of data just before it needs them.

## Topics

### Fetching Ranges from a File

[`-  fetchPartialContentsForItemWithIdentifier:version:request:minimalRange:aligningTo:options:completionHandler:`](/documentation/FileProvider/NSFileProviderPartialContentFetching/fetchPartialContents(for:version:request:minimalRange:aligningTo:options:completionHandler:))

Tells the file provider to download the requested item from remote storage.

[`NSFileProviderFetchContentsOptions`](/documentation/FileProvider/NSFileProviderFetchContentsOptions)

Options for fetching a range of data from a file.

[`NSFileProviderMaterializationFlags`](/documentation/FileProvider/NSFileProviderMaterializationFlags)

Flags that provides additional information about the provided content.

## Relationships

### Inherits From

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

---

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)