> 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

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-sharing/introduction.md

## Article Content:

# About the Data Sharing API

> **Note for app developers:** Wix Data APIs require the site's [code editor](https://dev.wix.com/docs/develop-websites/articles/get-started/development-environments.md) to be enabled. If you are building a Wix app, add a [data collections extension](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/data-collections/about-data-collections-extensions.md) to automatically enable the code editor and create data collections when your app is installed on a site.


The Data Sharing API enables collection sharing between multiple sites in the same Wix account. 
It allows for cross-site data collaboration while maintaining data integrity and collection permissions.

The Data Sharing API supports a 2-sided workflow where you can:
- Create and manage data sharing policies for sharing collections from a source site. 
- Connect to or disconnect from a sharing policy for accessing the shared collection on a target site. 

Shared collections are accessed through the CMS and the Data Items APIs using the collection ID. 

### Real-time synchronization
- Changes to shared data appear instantly across all connected sites. When you modify data items on the collection's source site or on a target site, the updates are immediately reflected everywhere.
- When a data sharing policy is deleted from a source site, the shared collection is immediately removed from any target sites connected to the policy. This can cause code in target sites to break. 

### Working with Data APIs
- Use the Data Items API to access, create, and update data items in the shared collections. 
- If you call [List Shared Data Collections](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-sharing/list-shared-data-collections.md), all shared collections the site is connected to are included in the response. 


## Before you begin

It's important to note the following before starting to code:

- Data collection sharing only works between sites in the same Wix account. You can't share collections with sites belonging to different Wix accounts.
- External collections connected to a site and Wix App collections can't be shared.
- When sharing a collection, the collection's permissions remain unchanged. This means if you share a collection, the target site inherits the collection's permissions as they exist in the source site.  


## Use cases

- [Distribute content across multi-locale marketing networks](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-sharing/sample-flows.md)
- [Notify connected sites when sharing policies change](https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-sharing/sample-flows.md)

## Terminology

- **Data sharing policy**: Defines which collection to share, optional filtering rules to restrict which items are shared, and serves as the access credential for other sites to connect to the shared collection.

- **Sharing or shared connection**: The active link between a source site and target site that enables data access.

- **Source site**: Site that owns the collection and creates and manages sharing policies for that collection.

- **Target site**: Site that connects to and accesses the shared collection using the data sharing policy ID.


@sdk_package_setup