Update docs and blogs to TablesDB terminology by atharvadeosthale · Pull Request #3037 · appwrite/website

atharvadeosthale · 2026-06-02T15:05:41Z

Summary

Reworked docs and blog content to replace legacy databases terminology with current tables, rows, and columns language where appropriate
Updated SDK examples to use object-based params across the supported languages, and corrected a few snippets that needed signature-specific field ordering
Kept API references and legacy linkage plumbing intact where they are generated or intentionally preserved

Testing

Node SDK object-param payloads were smoke-tested against the generated SDK
Changed JS/TS/Deno code fences were parsed successfully
Repo checks passed, including bun run check and diff whitespace validation

appwrite · 2026-06-02T15:06:55Z

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)

Site	Status	Logs	Preview	QR
website `69d7f2670014e24571ca`	Ready	View Logs	Preview URL

Tip

Build commands execute in runtime containers during deployment

adityaoberai

Please check for patterns of these issues across other blogs

Also, for every blog edited, we need to update the lastUpdated field in the frontmatter

adityaoberai · 2026-06-02T16:43:13Z

-  - question: "How does the Meilisearch sync function stay in sync with new documents?"
-    answer: "By default the template syncs documents on demand when the function runs. To keep the index up to date automatically, configure the function to trigger on database events (document.create, document.update, document.delete) so every change is mirrored to Meilisearch in near real time."
+  - question: "How does the Meilisearch sync function stay in sync with new rows?"
+    answer: "By default the template syncs rows on demand when the function runs. To keep the index up to date automatically, configure the function to trigger on database row events so every change is mirrored to Meilisearch in near real time."


We will need to update the function template as well for this to work properly

Also, let's not remove the events from there, we should mention the correct ones instead

adityaoberai · 2026-06-02T16:58:09Z

 For more information about Appwrite and Appwrite Functions:

-1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: These documents provide more information on how to use Appwrite Functions.
+1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.


Suggested change

1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.

1. **[Appwrite Function Docs](/docs/products/functions)**: Learn more about how to use Appwrite Functions.

adityaoberai · 2026-06-02T16:59:03Z

 For more information about Appwrite and Appwrite Functions:

-1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: These documents provide more information on how to use Appwrite Functions.
+1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.


Suggested change

1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.

1. **[Appwrite Function Docs](/docs/products/functions)**: Learn more about how to use Appwrite Functions.

adityaoberai · 2026-06-02T16:59:27Z

-1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: These documents provide more information on how to use Appwrite Functions.
+1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.
 2. **[Functions Announcement](https://dev.to/appwrite/serverless-your-way-unleashing-appwrite-functions-true-potential-2l4f)**: Read the full announcement on Functions 1.4.
 3. **[Appwrite Discord](https://discord.com/invite/appwrite)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.


Suggested change

3. **[Appwrite Discord](https://discord.com/invite/appwrite)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.

3. **[Appwrite Discord](/discord)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.

adityaoberai · 2026-06-02T16:59:47Z

-1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: These documents provide more information on how to use Appwrite Functions.
+1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: Learn more about how to use Appwrite Functions.
 2. **[Functions Announcement](https://dev.to/appwrite/serverless-your-way-unleashing-appwrite-functions-true-potential-2l4f)**: Read the full announcement on Functions 1.4.
 3. **[Appwrite Discord](https://discord.com/invite/appwrite)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.


Suggested change

3. **[Appwrite Discord](https://discord.com/invite/appwrite)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.

3. **[Appwrite Discord](/discord)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration.

adityaoberai · 2026-06-02T22:50:57Z

-    name: 'articles',
-    columns: [
-        {
-            key: 'title',
-            type: 'varchar',
-            size: 255,
-            required: true
-        },
-        {
-            key: 'summary',
-            type: 'text',
-            required: false
-        },
-        {
-            key: 'body',
-            type: 'mediumtext',
-            required: false
-        },
-        {
-            key: 'raw_data',
-            type: 'longtext',
-            required: false
-        }
-    ]


This does not need a change, does it?

adityaoberai · 2026-06-02T22:51:41Z

-Here’s what’s changed:
-
- Collections are now Tables
- Documents are now Rows
- Attributes are now Columns
+The updated wording now centers Appwrite Databases around tables, rows, and columns.

 To support the terminology change, we’ve added the TablesDB API.

 A new API layer that helps you work with relational database concepts like tables, columns, and rows, without requiring any changes to your existing apps.

-The old document-based methods are now deprecated and will no longer receive major upgrades. They will continue to receive security patches and essential maintenance, and we are ensuring backwards compatibility with those methods for the API, so there’s no need to migrate immediately if a specific issue arises.


Changes are unnecessary imho

adityaoberai · 2026-06-02T22:53:04Z

 const promise = teams.create(
-    'teachers',
-    'Teachers',
-    ['maths', 'sciences', 'arts', 'literature']
+    {
+    teamId: 'teachers',
+    name: 'Teachers',
+    roles: ['maths', 'sciences', 'arts', 'literature']
+}


formatting issues?

adityaoberai · 2026-06-02T22:54:01Z

+await teams.deleteMembership({
+    teamId: '<TEAM_ID>',
+    membershipId: '<MEMBERSHIP_ID>'
+});


These changes should not have been made in this PR, they add lots of extra bloat to review

Any changes to switch to object params should have been in a separate PR

adityaoberai · 2026-06-02T22:55:15Z


 - **Gradual migration.** You don't have to swap everything at once. Authentication can move first, then storage, then databases. Each service you migrate reduces your maintenance burden.
- **Data export and import.** Appwrite's databases are standard JSON/document stores. Exporting your existing data and importing it is straightforward for most data models.
+- **Data export and import.** Appwrite's databases store standard JSON row data. Exporting your existing data and importing it is straightforward for most data models.


not the right phrasing, we should just say they accept JSON inputs that are mapped to the table schema

Update docs and blogs for tables and rows terminology

51618cf

adityaoberai requested changes Jun 2, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update docs and blogs to TablesDB terminology#3037

Update docs and blogs to TablesDB terminology#3037
atharvadeosthale wants to merge 1 commit into
mainfrom
deprecate-old-terminology

atharvadeosthale commented Jun 2, 2026

Uh oh!

appwrite Bot commented Jun 2, 2026 •

edited

Loading

Uh oh!

adityaoberai left a comment

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

adityaoberai Jun 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	1. [Appwrite Function Docs](https://appwrite.io/docs/functions): Learn more about how to use Appwrite Functions.
	1. [Appwrite Function Docs](/docs/products/functions): Learn more about how to use Appwrite Functions.

	3. [Appwrite Discord](https://discord.com/invite/appwrite): Connect with other developers and the Appwrite team for discussion, questions, and collaboration.
	3. [Appwrite Discord](/discord): Connect with other developers and the Appwrite team for discussion, questions, and collaboration.

Conversation

atharvadeosthale commented Jun 2, 2026

Summary

Testing

Uh oh!

appwrite Bot commented Jun 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Appwrite Website

Uh oh!

adityaoberai left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

appwrite Bot commented Jun 2, 2026 •

edited

Loading