Skip to content
16 changes: 16 additions & 0 deletions src/routes/docs/products/databases/bulk-operations/+page.markdoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ Bulk operations can only be performed via the server-side SDKs. The client-side

For client applications that need bulk-like functionality, consider using [Appwrite Functions](/docs/products/functions) with proper rate limiting and validation.

{% info title="Important notes" %}
- Bulk operations do not trigger Functions, Webhooks, or Realtime events
- Collections that contain relationship attributes are not supported via bulk operations. Use individual document operations for collections with relationships
{% /info %}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you double check if this is still the case? Some of this might work now after 1.8 was released.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

relationships are not supported via bulk afaik. also this terminology needs an update. All legacy ones should go in the databases/legacy routes.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ItzNotABug sorry, i meant the triggering of functions, webhooks, and realtime events.


# Atomic behavior {% #atomic-behavior %}

Bulk operations in Appwrite are **atomic**, meaning they follow an all-or-nothing approach. Either all documents in your bulk request succeed, or all documents fail.
Expand All @@ -21,6 +26,17 @@ This atomicity ensures:

For example, if you attempt to create 100 documents and one fails due to a validation error, none of the 100 documents will be created.

# Plan limits {% #plan-limits %}

Bulk operations have different limits based on your Appwrite plan:

| Plan | Documents per request |
|------|----------------------|
| Free | 100 |
| Pro | 1,000 |

These limits apply to all bulk operations including create, update, upsert, and delete operations. If you need higher limits than what the Pro plan offers, you can [contact support](https://appwrite.io/contact-us/enterprise) to inquire about a custom plan.

# Create documents {% #create-documents %}

You can create multiple documents in a single request using the `createDocuments` method.
Expand Down
Loading