addProductMedia( )

Adds media items to a specified product, either via URL or existing media ID.

NOTE: The URL is not validated and no event is triggered to indicate if the media was added successfully.

Authentication
  • When developing websites or building an app with Blocks, this method may require elevated permissions, depending on the identity of the user calling it and the calling user’s permissions.
  • When building apps without Blocks or for headless projects, you can only call this method directly when authenticated as a Wix app or Wix user identity. When authenticated as a different identity, you can call this method using elevation.
  • Elevation permits users to call methods they typically cannot access. Therefore, you should only use it intentionally and securely.
Permissions
Manage Stores - all permissions
Manage Products
Learn more about app permissions.
Method Declaration
Copy
function addProductMedia(
  _id: string,
  media: Array<MediaDataForWrite>,
): Promise<void>;
Method Parameters
_idstringRequired

Product ID.

mediaArray<MediaDataForWrite>Required

Sources of media items already uploaded to the Wix site.

JavaScript
import { products } from "@wix/stores";

async function addProductMedia(id, media) {
  const response = await products.addProductMedia(id, media);
}
Errors

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

Did this help?