> 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 # RemoveDataItem # Package: cms # Namespace: DataItemService # Method link: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/remove-data-item.md ## Permission Scopes: Write Data Items: SCOPE.DC-DATA.WRITE ## Introduction Removes an item from a collection. If any items in other collections reference the removed item in reference or multi-reference fields, those fields are cleared. > **Note:** > Once an item has been removed from a collection, it can't be restored. --- ## REST API ### Schema ``` Method: removeDataItem Description: Removes an item from a collection. If any items in other collections reference the removed item in reference or multi-reference fields, those fields are cleared. > **Note:** > Once an item has been removed from a collection, it can't be restored. URL: https://www.wixapis.com/wix-data/v2/items/{dataItemId} Method: DELETE # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: dataItemId, dataCollectionId Method parameters: query param name: appOptions | type: appOptions | description: Additional parameters specific to the [Wix app collection](https://support.wix.com/en/article/cms-formerly-content-manager-working-with-wix-app-collections) you are querying. When querying the Wix Stores [Products collection](https://dev.wix.com/docs/develop-websites/articles/wix-apps/wix-e-commerce-stores/wix-stores-products-collection-fields.md), pass the following optional parameters: - `includeHiddenProducts`: Whether to include hidden products in the response. Default: `false`. - `includeVariants`: Whether to include product variants in the query. Default: `false`. param name: condition | type: Condition - name: filter | type: object | description: Filter, changes to item(s) will only apply if they satisfy this filter. Learn more about filters in [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language.md#filters). query param name: dataCollectionId | type: dataCollectionId | description: GUID of the collection from which to remove the item. | required: true param name: dataItemId | type: none | required: true param name: publishPluginOptions | type: PublishPluginOptions - name: includeDraftItems | type: boolean | description: Whether to include draft items. When `true`, both published and draft items are affected. Default: `false`. Return type: RemoveDataItemResponse - name: dataItem | type: DataItem | description: Removed item. - name: id | type: string | description: Data item GUID. - name: dataCollectionId | type: string | description: GUID of the collection this item belongs to - name: data | type: object | description: Data item contents. Property-value pairs representing the data item's payload. When retrieving a data item, it also includes the following read-only fields: + `_id`: Item GUID. + `_createdDate`: Date and time the item was added to the collection. + `_updatedDate`: Date and time the item was last modified. When the item is first inserted, `_createdDate` and `_updatedDate` have the same value. + `_ownerId`: GUID of the user who created the item. Can be modified with site owner permissions. ``` ### Examples ### Remove an item: Delete a deactivated account. ```curl curl -X DELETE \ 'https://www.wixapis.com/wix-data/v2/items/5331fc15-9441-4fd4-bc7b-7f6870c69228?dataCollectionId=cities' \ -H 'Authorization: ' \ -d '{ "condition": { "filter": { "status": "Deactivated" } } }' ``` ### Remove existing item with complex id ```curl curl -X POST \ 'https://www.wixapis.com/wix-data/v2/items/remove' \ -H 'Content-Type: application/json' \ -H 'Authorization: ' \ -d '{ "dataCollectionId": "cities", "dataItemId": "%id1" }' ``` ### Remove existing item ```curl curl -X DELETE \ 'https://www.wixapis.com/wix-data/v2/items/5331fc15-9441-4fd4-bc7b-7f6870c69228?dataCollectionId=cities' \ -H 'Authorization: ' \ ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.cms.DataItemService.removeDataItem(dataCollectionId, itemId, options) Description: Removes an item from a collection. If any items in other collections reference the removed item in reference or multi-reference fields, those fields are cleared. > **Note:** > Once an item has been removed from a collection, it can't be restored. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: dataCollectionId, itemId Method parameters: param name: dataCollectionId | type: string | description: GUID of the collection from which to remove the item. | required: true param name: itemId | type: string | description: GUID of the item to remove. | required: true param name: options | type: WixDataRemoveOptions none - name: suppressHooks | type: boolean | description: Whether to suppress data hooks. When `true`, data hooks typically triggered by this endpoint don't run. **Note:** This option can only be used in code that runs in [the Wix site backend](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/backend-code/about-the-site-backend.md). Default: `false` - name: appOptions | type: object | description: Additional parameters specific to the [Wix app collection](https://support.wix.com/en/article/cms-formerly-content-manager-working-with-wix-app-collections) you are querying. When querying the Wix Stores [Products collection](https://dev.wix.com/docs/develop-websites/articles/wix-apps/wix-e-commerce-stores/wix-stores-products-collection-fields.md), pass the following optional parameters: - `includeHiddenProducts`: Whether to include hidden products in the response. Default: `false`. - `includeVariants`: Whether to include product variants in the query. Default: `false`. - name: condition | type: Condition | description: Condition for removing the item. When a condition is provided, the item is only removed if the condition is met. - name: filter | type: object | description: Filter, changes to item(s) will only apply if they satisfy this filter. Learn more about filters in [API Query Language](https://dev.wix.com/docs/rest/articles/get-started/api-query-language.md#filters). - name: showDrafts | type: boolean | description: When `true`, operations include draft items. Read operations include draft items in their response, and write operations modify draft items. Return type: PROMISE - name: _id | type: string | description: Data item GUID. - name: _createdDate | type: Date | description: Date and time the item was added to the collection. - name: _updatedDate | type: Date | description: Date and time the item was last modified. When the item is first inserted, `_createdDate` and `_updatedDate` have the same value. - name: _owner | type: string | description: GUID of the user who created the item. Can be modified with site owner permissions. ``` ### Examples ### remove ```javascript import { items } from '@wix/data'; async function remove(dataCollectionId,itemId,options) { const response = await items.remove(dataCollectionId,itemId,options); }; ``` ### remove (with elevated permissions) ```javascript import { items } from '@wix/data'; import { auth } from '@wix/essentials'; async function myRemoveMethod(dataCollectionId,itemId,options) { const elevatedRemove = auth.elevate(items.remove); const response = await elevatedRemove(dataCollectionId,itemId,options); } ``` ### remove (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { items } from '@wix/data'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { items }, // Include the auth strategy and host as relevant }); async function remove(dataCollectionId,itemId,options) { const response = await myWixClient.items.remove(dataCollectionId,itemId,options); }; ``` ---