> 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 # Method name: data.items.save(dataCollectionId: string, item: any, options: WixDataSaveOptions) # Method Link: https://dev.wix.com/docs/sdk/data-items-sdk/data/items/save.md # Method Description: Inserts or updates an item in a collection. The `save()` method returns a Promise that resolves to the inserted or updated item after it has been added or updated in the specified collection. The Promise is rejected if the current user does not have the necessary permissions for the collection. The `save()` method inserts or updates the specified item, depending on whether it already exists in the collection. It compares the `_id` property value of the specified item with the `_id` property values of the items in the specified collection. If an item in the collection has that `_id` value, `save()` uses `update()` to update the item in the collection, triggering the `beforeUpdate()` and `afterUpdate()` hooks if they have been defined. If none of the items in the collection contain that `_id` value, the specified item does not have an `_id` property, or if the specified item's id property is `undefined`, `save()` uses `insert()` to add the specified item to the collection. This triggers the [`beforeInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/before-insert.md) and [`afterInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/after-insert.md) hooks if they have been defined. When saving an item to a collection that has a reference field, set the value of the reference field to the referenced item's `_id` value or the entire referenced item object. When saving an item to a collection that has a multi-reference field, set the value of the multi-reference field to an array of the referenced items' `_id` values or an array of the entire referenced item objects. To save multi-reference values, specify `saveReferences: true` in the `options` object. > **Notes:** > - The maximum size of an item that you can save to a collection is 500kb. > - If an item's `_id` property value is set to null or an empty string, an error is thrown. > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling `save()` fails and issues an error. # Method Permissions: - Write Data Items # Method Permissions Scopes IDs: - SCOPE.DC-DATA.WRITE # Method Code Examples: ## Save an item in a collection ```javascript import { items } from "@wix/data"; async function saveItem() { const toSave = { "title": "Mr.", "first_name": "John", "last_name": "Doe" }; const savedItem = await items.save("myCollection", toSave); console.log(savedItem); // See below } /* item is: * * { * "_id": "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i", * "_owner": "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb", * "_createdDate": "2017-05-24T12:33:18.938Z", * "_updatedDate": "2017-05-24T12:33:18.938Z", * "title": "Mr.", * "first_name": "John", * "last_name": "Doe" * } */ ``` ## Save an item with a specified ID in a collection ```javascript import { items } from "@wix/data"; async function saveItem() { const toSave = { "_id": "00001", "title": "Mr.", "first_name": "John", "last_name": "Doe" }; const savedItem = await items.save("myCollection", toSave); console.log(savedItem); // See item } /* item is: * * { * "_id": "00001", * "_owner": "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb", * "_createdDate": "2017-05-24T12:33:18.938Z", * "_updatedDate": "2017-05-24T12:33:18.938Z", * "title": "Mr.", * "first_name": "John", * "last_name": "Doe" * } */ ``` ## Save an item including a reference to another item using the referenced item's ID ```javascript import { items } from "@wix/data"; async function saveItem() { const countryId = "id-of-usa-item"; const toSave = { "title": "Mr.", "first_name": "John", "last_name": "Doe", "country": countryId }; const savedItem = await items.save("myCollection", toSave); console.log(savedItem); // See below } /* item is: * * { * "_id": "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i", * "_owner": "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb", * "_createdDate": "2017-05-24T12:33:18.938Z", * "_updatedDate": "2017-05-24T12:33:18.938Z", * "title": "Mr.", * "first_name": "John", * "last_name": "Doe", * "country": "id-of-usa-item" * } */ ``` ## Save an item including a reference to another item using the reference item ```javascript import { items } from "@wix/data"; async function saveItem() { const countryItem = // Get country item const toSave = { "title": "Mr.", "first_name": "John", "last_name": "Doe", "country": countryItem }; const savedItem = await items.save("myCollection", toSave); console.log(savedItem); // See below } /* item is: * * { * "_id": "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i", * "_owner": "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb", * "_createdDate": "2017-05-24T12:33:18.938Z", * "_updatedDate": "2017-05-24T12:33:18.938Z", * "title": "Mr.", * "first_name": "John", * "last_name": "Doe", * "country": "id-of-usa-item" * } */ ``` ## default ```javascript try { const result = await items.save("collection-0.5404437414642547", { _id: "6892593d-d57f-428d-bc53-3f0870a1beef", name: "Updated Item", phoneNumber: "+972501234567", date: Date.now(), image: "https://static.wixstatic.com/media/503ea4_ed9a38760ae04aab86b47e82525fdcac~mv2.jpg" }, { suppressHooks: false }); return result; } catch (error) { console.error(error); throw error; } ```