insertDataItemReference( )


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Inserts a reference in the specified field in an item in a collection.

A reference in options.dataItemReference specifies a referring item's ID, the field in which to insert the reference, and the ID of the referenced item.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage All Data Resources
Manage Data Items
Write Data Items
Learn more about app permissions.
Method Declaration
Copy
function insertDataItemReference(
  options: InsertDataItemReferenceOptions,
): Promise<InsertDataItemReferenceResponse>;
Method Parameters
optionsInsertDataItemReferenceOptions

Options for inserting a reference.

Returns
Return Type:Promise<InsertDataItemReferenceResponse>
JavaScript
import { items } from "@wix/data"; async function insertDataItemReference(options) { const response = await items.insertDataItemReference(options); }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?