<!--
{
  "availability" : [
    "iOS: 3.0.0 -",
    "iPadOS: 3.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.6.0 -",
    "tvOS: -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreData",
  "identifier" : "/documentation/CoreData/NSFetchRequest/includesPendingChanges",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Core Data"
    ],
    "preciseIdentifier" : "c:objc(cs)NSFetchRequest(py)includesPendingChanges"
  },
  "title" : "includesPendingChanges"
}
-->

# includesPendingChanges

A Boolean value that indicates whether, when the fetch is executed, it matches against currently unsaved changes in the managed object context.

```
var includesPendingChanges: Bool { get set }
```

## Discussion

This value is <doc://com.apple.documentation/documentation/Swift/true> if when the fetch is executed, the fetch will match against currently unsaved changes in the managed object context; otherwise the value is <doc://com.apple.documentation/documentation/Swift/false>. The default value is <doc://com.apple.documentation/documentation/Swift/true>.

If the value is <doc://com.apple.documentation/documentation/Swift/false>, the fetch request doesn’t check unsaved changes and only returns objects that matched the predicate in the persistent store.

### Special Considerations

A value of <doc://com.apple.documentation/documentation/Swift/true> is not supported in conjunction with the result type [`dictionaryResultType`](/documentation/CoreData/NSFetchRequestResultType/dictionaryResultType), including calculation of aggregate results (such as `max` and `min`). For dictionaries, the array returned from the fetch reflects the current state in the persistent store, and does not take into account any pending changes, insertions, or deletions in the context.

If you need to take pending changes into account for some simple aggregations like `max` and `min`, you can instead use a normal fetch request, sorted on the attribute you want, with a fetch limit of 1.

---

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)