> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> 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`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - 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: About Schema Plugins

## Article: About Schema Plugins

## Article Link: https://dev.wix.com/docs/studio-two/code-your-site/build-a-custom-backend/schema-plugins/about-schema-plugins.md

## Article Content:

# About Schema Plugins

A [schema plugin](https://dev.wix.com/docs/overview/extensions-framework/backend-extensions/schema-plugins.md) adds custom fields to a Wix object, such as a product or a booking, without changing the object's predefined fields. Use one when an object that supports schema plugins lacks a field your site needs, such as a warranty on a product, and you want the value stored on the object itself, where the object's API returns it.

On a Studio Two site, your site code can add fields that only your site has. It defines them in a schema with the [Data Extension Schema API](https://dev.wix.com/docs/api-reference/business-management/data-extension-schema/introduction.md), and then reads and writes their values through the object's own API.

## How site code adds custom fields

Fields that belong to one site live in the `_user_fields` namespace, which keeps them apart from fields that apps add to the same object. A site has at most one `_user_fields` schema for each object, and each field in it has a type and permissions. For the rules that apply to every schema plugin, including where values appear on the object and what each permission means, see [About Schema Plugins](https://dev.wix.com/docs/backend-extensions/schema-plugins/about-schema-plugins.md).

Your site code works with fields in two places:

- **The schema:** An [HTTP endpoint](https://dev.wix.com/docs/studio-two/code-your-site/build-a-custom-backend/http-endpoints/about-http-endpoints.md) in your site project calls the API from `@wix/data-extension-schema` to create or update the `_user_fields` schema. The endpoint checks the caller and calls these methods with the caller's own permissions, so Wix checks that the caller's role allows the change.
- **The values:** Code reads and writes a field's value through the object's own API, such as Update Product for a product. The value is in the object's `extendedFields.namespaces._user_fields`.

For the steps, see [Add Custom Fields to a Wix Object in Studio Two](https://dev.wix.com/docs/studio-two/code-your-site/build-a-custom-backend/schema-plugins/add-custom-fields-to-a-wix-object-in-studio-two.md).

## Which objects you can extend

Objects that support schema plugins, such as products, eCommerce orders, and bookings, have an `extendedFields` property. For the list, see [Supported Objects](https://dev.wix.com/docs/api-reference/business-management/data-extension-schema/supported-objects.md).

## Rules for changing a schema

Once a field exists, you can only make changes to it that don't break stored data. These rules also apply:

- An update must include every field the schema already has. To remove a field, call [Delete User Defined Fields](https://dev.wix.com/docs/api-reference/business-management/data-extension-schema/delete-user-defined-fields.md).
- No method deletes a whole schema, so the schema stays after you delete its fields.

For field types, formats, and limits, see [The JSON Schema](https://dev.wix.com/docs/api-reference/business-management/data-extension-schema/the-json-schema.md).

## See also

- [Add Custom Fields to a Wix Object in Studio Two](https://dev.wix.com/docs/studio-two/code-your-site/build-a-custom-backend/schema-plugins/add-custom-fields-to-a-wix-object-in-studio-two.md)
- [About Schema Plugins](https://dev.wix.com/docs/backend-extensions/schema-plugins/about-schema-plugins.md)
- [Data Extension Schema API](https://dev.wix.com/docs/api-reference/business-management/data-extension-schema/introduction.md)