---
title: forceReplace
framework: CloudKit JS
role: symbol
role_heading: Instance Method
platforms: [cloudkit js 1.0+]
path: cloudkitjs/cloudkit.recordsbatchbuilder/forcereplace
---

# forceReplace

Replaces one or more records with the specified records regardless of conflicts.

## Declaration

```data
CloudKit.RecordsBatchBuilder forceReplace(
	CloudKit.Record|CloudKit.Record[] records,
	optional Object options
);
```

## Parameters

- `records`: A doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Record dictionary representing the replacement record, if you are replacing a single record. If you are replacing multiple records, this value is an array of replacement doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Record dictionaries. The recordChangeTag key is not required in the doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Record dictionaries. Only the values of the fields in these dictionaries are replaced. The other field values are set to null.
- `options`: A dictionary containing options for this operation. This parameter contains a single desiredKeys key that is an array of field names (String values). Only the fields specified in the array are set.

## Return Value

Return Value The object that received this method call.

## Discussion

Discussion Creates records if they don’t exist.

## See Also

### Replacing Records

- [replace](cloudkitjs/cloudkit.recordsbatchbuilder/replace.md)