<!--
{
  "availability" : [
    "iOS: 8.0.0 -",
    "iPadOS: 8.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.10.0 -",
    "tvOS: -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreData",
  "identifier" : "/documentation/CoreData/NSBatchUpdateRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Core Data"
    ],
    "preciseIdentifier" : "c:objc(cs)NSBatchUpdateRequest"
  },
  "title" : "NSBatchUpdateRequest"
}
-->

# NSBatchUpdateRequest

A request to Core Data to do a batch update of data in a persistent store without loading any data into memory.

```
class NSBatchUpdateRequest
```

## Topics

### Creating a Request

[`-  initWithEntity:`](/documentation/CoreData/NSBatchUpdateRequest/init(entity:))

Creates a batch-update request for a managed entity.

[`-  initWithEntityName:`](/documentation/CoreData/NSBatchUpdateRequest/init(entityName:))

Creates a batch-update request for a named managed entity.

[`+  batchUpdateRequestWithEntityName:`](/documentation/CoreData/NSBatchUpdateRequest/batchUpdateRequestWithEntityName:)

Creates a batch-update request for a named managed entity.

### Configuring a Request

[`entity`](/documentation/CoreData/NSBatchUpdateRequest/entity)

The managed entity to update data for.

[`entityName`](/documentation/CoreData/NSBatchUpdateRequest/entityName)

The name of the managed entity to update data for.

[`includesSubentities`](/documentation/CoreData/NSBatchUpdateRequest/includesSubentities)

A Boolean value that indicates whether to update subentities.

[`predicate`](/documentation/CoreData/NSBatchUpdateRequest/predicate)

A predicate that identifies the objects to update.

[`propertiesToUpdate`](/documentation/CoreData/NSBatchUpdateRequest/propertiesToUpdate)

A dictionary of property description pairs that describe the updates.

[`resultType`](/documentation/CoreData/NSBatchUpdateRequest/resultType)

The type of result that Core Data returns from the request.

## Relationships

### Conforms To

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

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

[`Hashable`](/documentation/Swift/Hashable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSCopying`](/documentation/Foundation/NSCopying)

### Inherits From

[`NSPersistentStoreRequest`](/documentation/CoreData/NSPersistentStoreRequest)

---

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)