> 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: Namespaces

## Article: Namespaces

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/benefit-programs/namespaces.md

## Article Content:

# Namespaces

Many entities in the Benefits Programs APIs include a required `namespace` property. You must use the same namespace for all entities created by your app or directly by your site. Namespaces allow you to distinguish between entities that you created and entities that other apps created.

For example, let's say you want to retrieve all [items](https://dev.wix.com/docs/api-reference/business-solutions/benefit-programs/introduction.md) with a specific category. You can call [Query Items](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/items/query-items.md) and filter by `category`. However, there may be another app that created items and used the same category name. To ensure that you're retrieving only the items that you created, you can also filter by `namespace`.

The following entities include a required `namespace` field:
- [Program definitions](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/program-definitions/program-definition-object.md)
- [Pool definitions](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/pool-definitions/pool-definition-object.md)
- [Programs](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/programs/program-object.md)
- [Pools](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/pools/pool-object.md)
- [Items](https://dev.wix.com/docs/rest/business-solutions/benefit-programs/items/item-object.md)

> **Note:** Many entities contain an `extendedFields` object which contains a `namespaces` field. This is different to the namespace you use for your benefit programs. Learn more about [extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md).