> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name:

data.items.replaceReferences(dataCollectionId: string, field: string, referringItem: any, referencedItem: any, options: WixDataOptions)

# Method Link:

https://dev.wix.com/docs/sdk/data-items-sdk/data/items/replace-references.md

# Method Description:

Replaces current references with references in the specified property.

The `replaceReferences()` method returns a Promise that resolves when the
item's current references in the specified property are removed and
references to the referenced items are added in their place. The Promise is
rejected if the current user does not have update permissions for the
collection.


> **Note:** The `replaceReferences()` method is not supported for [single-item collections](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection).

# Method Permissions:

- Write Data Items

# Method Permissions Scopes IDs:

- SCOPE.DC-DATA.WRITE



# Method Code Examples:

## Replace a reference

```javascript
import { items } from "@wix/data";

async function replaceItemReferences() {
  await items.replaceReferences("movies", "actors", "00001", "12345");
  console.log("References replaced");
}
```



## Replace references using an array

```javascript
import { items } from "@wix/data";

async function replaceItemReferences() {
  await items.replaceReferences("movies", "actors", "00001", ["12345", "67890"]);
  console.log("References replaced");
}
```

## default

```javascript
try {
      const result = await items.replaceReferences(
          "collection-0.6094022595633535",
          "refs",
          "6892593d-d57f-428d-bc53-3f0870a1beef",
          ["3b90c0aa-d723-4792-8c52-ff1b7b927b3e"],
          { showDrafts: false }
      );
      return result;
    } catch (error) {
      console.error(error);
      throw error;
   }
```