> 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: replaceReferences(collectionId: string, propertyName: string, referringItem: any, referencedItem: any, options: WixDataOptions)

# Method package: wixData

# Method menu location: wixData --> replaceReferences

# Method Link: https://dev.wix.com/docs/velo/apis/wix-data/replace-references.md

# Method Description:

Replaces current references with references in the specified property.

The `replaceReferences()` function 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.

 Calling the `replaceReferences()` function does not trigger any hooks.

>**Note:** The `replaceReferences()` function is not supported for Single Item Collections.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Replace a reference

```javascript
import wixData from 'wix-data';

// ...

wixData.replaceReferences("movies", "actors", "00001", "12345")
  .then(() => {
    console.log("References replaced");
  })
  .catch((error) => {
    console.log(error);
  });

```

## Replace references using an array

```javascript
import wixData from 'wix-data';

// ...

wixData.replaceReferences("movies", "actors", "00001", ["12345", "67890"])
  .then(() => {
    console.log("References replaced");
  })
  .catch((error) => {
    console.log(error);
  });

```

---