---
title: Push and update your catalog data
slug: p48b0322
canonical_url: https://docs.coveo.com/en/p48b0322/
collection: coveo-for-commerce
source_format: adoc
---
# Push and update your catalog data
To push or update your [catalog data](https://docs.coveo.com/en/obcf0333/) in your [source](https://docs.coveo.com/en/246/) (typically a [Catalog source](https://docs.coveo.com/en/l5if0244/)), you have to interact with the [Coveo Stream API](https://docs.coveo.com/en/12#tag/Stream).

The Coveo Stream API supports several operations for managing your catalog data.
The following table indicates the operations available in the Coveo Stream API depending on whether you want to perform full or partial updates:

[%header,cols="2*"]
|===
|Update type
|Operation

.2+|[Full catalog data updates](https://docs.coveo.com/en/p4eb0129/)
|[Update](https://docs.coveo.com/en/p4eb0129#update-operations) (recommended)
|[Load](https://docs.coveo.com/en/p4eb0129#load-operations)

.2+|[Partial catalog data updates](https://docs.coveo.com/en/p4eb0515/)
|[Partial item updates](https://docs.coveo.com/en/p4eb0515#partial-item-updates)
|[Shallow merge](https://docs.coveo.com/en/p4eb0515#shallow-merge-operations)
|===

## Usage

The following table maps which operation to use depending on your use case:

[%header,cols="2",options="header"]
|===
|Operation
|Use case

|[Update](https://docs.coveo.com/en/p4eb0129#update-operations)
a|* Push your catalog data to your source.

* Update the entire catalog data in your source via multiple update operations.

* To update all the [fields](https://docs.coveo.com/en/200/) in a given [item](https://docs.coveo.com/en/pa8f6515/).

* Add and delete items.

|[Load](https://docs.coveo.com/en/p4eb0129#load-operations)
a|To overwrite the entire catalog data in your [source](https://docs.coveo.com/en/246/) with the provided data.  
This operation shouldn't be used for sources with more than 1,000,000 items, as it may lead to timeouts, excessive memory usage, or degraded performance.

> **Leading practice**
>
> Update operations provide the same benefits as the load operation but with better performance and fewer limitations.

|[Partial item updates](https://docs.coveo.com/en/p4eb0515#partial-item-updates)
|To update one or more fields in a given item without overwriting the entire item.  
This is useful when you want to update only specific fields without affecting the rest of the item data.

|[Shallow merge](https://docs.coveo.com/en/p4eb0515#shallow-merge-operations)
|To update one or more fields in an item.  
This operation should be used when it's impossible to validate the existence of an item in the source before partially updating it.  
It can be used only with the [Catalog source](https://docs.coveo.com/en/l5if0244/).
|===

## Required privileges

The following table indicates the [privileges](https://docs.coveo.com/en/228/) required for your [organization](https://docs.coveo.com/en/185/)’s [groups](https://docs.coveo.com/en/2867/) to view or edit elements of the [**Catalogs**](https://platform.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/commerce/catalogs/)) page and its associated panels (see [Manage privileges](https://docs.coveo.com/en/3151/) and [Privilege reference](https://docs.coveo.com/en/1707/)).
The **Commerce** domain is only available to [organizations](https://docs.coveo.com/en/185/) in which Coveo for Commerce features are enabled.
[cols="3",options="header"]
|===
|Action
|Service - Domain
|Required access level

|View catalogs
|Commerce - Catalogs  
Content - Sources  
Content - Fields  
Organization - Organization
|View

.3+.^|Edit catalogs
|Content - Fields  
Content - Sources  
Organization - Organization
|View

|Commerce - Catalogs
|Edit

|Search - Execute Query
|Allowed
|===