Skip to content

preview: add Serverless name change notice #21373

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 12 commits into
base: feature/rename-serverless
Choose a base branch
from
Open

preview: add Serverless name change notice #21373

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
3a59e0e
release-cloud: add Serverless name change notice
lilin90 Jul 10, 2025
288dfe7
Update select-cluster-tier.md
lilin90 Jul 10, 2025
b42ad60
Update wording for consistency
lilin90 Jul 10, 2025
bd9cb9f
tidb-cloud: update affected anchor links
lilin90 Jul 16, 2025
e8ab465
Update serverless-faqs.md
lilin90 Jul 22, 2025
8fe74a9
tidb-cloud: add a rename faq
lilin90 Jul 22, 2025
cbc5d94
Update wording
lilin90 Jul 22, 2025
16cb871
Update tidb-cloud-intro.md
lilin90 Jul 22, 2025
4950756
Add links
lilin90 Jul 22, 2025
174f2bc
Fix anchor link
lilin90 Jul 22, 2025
c5a6888
Update tidb-cloud/serverless-faqs.md
lilin90 Jul 22, 2025
c948fda
Apply suggestions from code review
lilin90 Jul 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion develop/dev-guide-build-cluster-in-cloud.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ summary: Learn how to build a TiDB Cloud Starter cluster in TiDB Cloud and conne

<CustomContent platform="tidb">

This document walks you through the quickest way to get started with TiDB. You will use [TiDB Cloud](https://www.pingcap.com/tidb-cloud) to create a TiDB Cloud Starter cluster, connect to it, and run a sample application on it.
This document walks you through the quickest way to get started with TiDB. You will use [TiDB Cloud](https://www.pingcap.com/tidb-cloud) to create a TiDB Cloud Starter (formerly Serverless) cluster, connect to it, and run a sample application on it.

If you need to run TiDB on your local machine, see [Starting TiDB Locally](/quick-start-with-tidb.md).

Expand Down
4 changes: 2 additions & 2 deletions tidb-cloud/create-tidb-cluster-serverless.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ If you are in the `Organization Owner` or the `Project Owner` role, you can crea

2. Click **Create Cluster**.

3. Select a cluster plan. TiDB Cloud provides two [cluster plans](/tidb-cloud/select-cluster-tier.md#cluster-plans): **Starter** and **Essential**. You can start with a Starter cluster and later upgrade to an Essential cluster as your needs grow.
3. Select a cluster plan. TiDB Cloud provides two [cluster plans](/tidb-cloud/select-cluster-tier.md): **Starter** and **Essential**. You can start with a Starter cluster and later upgrade to an Essential cluster as your needs grow.

4. The cloud provider is Alibaba Cloud. You can select an Alibaba Cloud region where you want to host your cluster.

Expand All @@ -33,7 +33,7 @@ If you are in the `Organization Owner` or the `Project Owner` role, you can crea

- You can update the spending limit for your cluster. If the spending limit is set to 0, the cluster remains in the free tier. If the spending limit is greater than 0, you need to add a credit card before creating the cluster.

- By default, each organization can create up to five [free Starter clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create additional Starter clusters, you must add a credit card and specify a spending limit.
- By default, each organization can create up to five [free Starter clusters](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) by default. To create additional Starter clusters, you must add a credit card and specify a spending limit.

- Essential plan:

Expand Down
2 changes: 1 addition & 1 deletion tidb-cloud/manage-serverless-spend-limit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ summary: Learn how to manage spending limit for your TiDB Cloud Starter scalable

Spending limit refers to the maximum amount of money that you are willing to spend on a particular workload in a month. It is a cost-control mechanism that allows you to set a budget for your TiDB Cloud Starter scalable clusters.

For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and create scalable clusters for the usage. But if you delete some of your previous clusters before creating more, the new cluster can still be created without a credit card.
For each organization in TiDB Cloud, you can create a maximum of five [free Starter clusters](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and create scalable clusters for the usage. But if you delete some of your previous clusters before creating more, the new cluster can still be created without a credit card.

## Usage quota

Expand Down
14 changes: 4 additions & 10 deletions tidb-cloud/select-cluster-tier.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,30 +9,24 @@ The cluster plan determines the throughput and performance of your cluster.

TiDB Cloud provides the following two options of cluster plan. Before creating a cluster, you need to consider which option suits your need better.

- [TiDB Cloud Starter](#tidb-cloud-starter)
- [TiDB Cloud Starter](#tidb-cloud-starter) (formerly Serverless)
- [TiDB Cloud Essential](#tidb-cloud-essential)
<!--TBD, ToDo-->

## TiDB Cloud Starter

<!--To be confirmed-->
TiDB Cloud Starter is a fully managed, multi-tenant TiDB offering. It delivers an instant, autoscaling MySQL-compatible database and offers a generous free plan and consumption based billing once free limits are exceeded.
TiDB Cloud Starter (formerly Serverless) is a fully managed, multi-tenant TiDB offering. It delivers an instant, autoscaling MySQL-compatible database.

### Cluster plans

TiDB Cloud Starter offers two service plans to meet different user requirements. Whether you are just getting started or scaling to meet the increasing application demands, these service plans provide the flexibility and capability you need.

#### Free cluster plan

The free cluster plan is ideal for those who are getting started with TiDB Cloud Starter. It provides developers and small teams with the following essential features:
The Starter cluster plan is ideal for those who are getting started with TiDB Cloud Starter. It provides developers and small teams with the following features:

- **No cost**: This plan is completely free, with no credit card required to get started.
- **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage.
- **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit) for database operations.

### Usage quota

For each organization in TiDB Cloud, you can create a maximum of five [free clusters](#free-cluster-plan) by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and specify a spending limit.
For each organization in TiDB Cloud, you can create a maximum of five free Starter clusters by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and specify a spending limit.

For the first five TiDB Cloud Starter clusters in your organization, whether they are free or scalable, TiDB Cloud provides a free usage quota for each of them as follows:

Expand Down
19 changes: 17 additions & 2 deletions tidb-cloud/serverless-faqs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,30 @@

### What is TiDB Cloud Starter?

TiDB Cloud Starter offers the TiDB database with full HTAP capabilities for you and your organization. It is a fully managed, auto-scaling deployment of TiDB that lets you start using your database immediately, develop and run your application without caring about the underlying nodes, and automatically scale based on your application's workload changes.
TiDB Cloud Starter (formerly Serverless) offers the TiDB database with full HTAP capabilities for you and your organization. It is a fully managed, auto-scaling deployment of TiDB that lets you start using your database immediately, develop and run your application without caring about the underlying nodes, and automatically scale based on your application's workload changes.

### What is the relationship between TiDB Cloud Starter and TiDB Cloud Serverless?

TiDB Cloud Starter is the new name for TiDB Cloud Serverless, effective August 12, 2025.

Before it was renamed to Starter, the Serverless tier of TiDB Cloud served as the entry point for thousands of developers, providing a production-ready database that scales automatically, starts in seconds, and costs nothing until you exceed a generous free quota.

While "serverless" accurately describes how the service works behind the scenes, many first-time users told us this word felt abstract and overloaded with meanings.

Check warning on line 24 in tidb-cloud/serverless-faqs.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[PingCAP.Ambiguous] Consider using a clearer word than 'many' because it may cause confusion.

Raw Output:
{"message": "[PingCAP.Ambiguous] Consider using a clearer word than 'many' because it may cause confusion.", "location": {"path": "tidb-cloud/serverless-faqs.md", "range": {"start": {"line": 24, "column": 82}}}, "severity": "INFO"}

We renamed this entry tier to Starter so its purpose is crystal clear: it is the quickest way to begin building with TiDB Cloud. Everything you enjoy with Serverless remains unchanged:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggest we use AI to shorten this paragraph so we can keep each FAQ question short and concise.

Copy link
Member Author

Choose a reason for hiding this comment

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

Updated in #21437


- A fully managed database with both row-based and columnar storage, ideal for hybrid OLTP and OLAP workloads.
- Automatic and request-driven scaling, no capacity planning or manual tuning required.
- Built-in vector search and full-text search to power GenAI retrieval, chatbots, and other AI applications.
- Always-free monthly quota for up to five clusters per organization (5 GiB row data + 5 GiB columnar data + 50 million [RUs](/tidb-cloud/tidb-cloud-glossary.md#request-unit) per cluster).

### How do I get started with TiDB Cloud Starter?

Get started with the 5-minute [TiDB Cloud Quick Start](/tidb-cloud/tidb-cloud-quickstart.md).

### How many TiDB Cloud Starter clusters can I create in TiDB Cloud?

For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default.
For each organization in TiDB Cloud, you can create a maximum of five [free Starter clusters](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) by default.

### Are all TiDB Cloud features fully supported on TiDB Cloud Starter?

Expand Down
2 changes: 1 addition & 1 deletion tidb-cloud/serverless-limitations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ If you require the features listed in this document, [contact us](https://www.pi

## Usage quota

For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and specify a spending limit.
For each organization in TiDB Cloud, you can create a maximum of five [free Starter clusters](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) by default. To create more TiDB Cloud Starter clusters, you need to add a credit card and specify a spending limit.

For the first five TiDB Cloud Starter clusters in your organization, whether they are free or scalable, TiDB Cloud provides a free usage quota for each of them as follows:

Expand Down
4 changes: 2 additions & 2 deletions tidb-cloud/tidb-cloud-intro.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

# What is TiDB Cloud

[TiDB Cloud](https://www.pingcap.com/tidb-cloud/) is a fully-managed Database-as-a-Service (DBaaS) that brings [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source Hybrid Transactional and Analytical Processing (HTAP) database, to your cloud. TiDB Cloud offers an easy way to deploy and manage databases to let you focus on your applications, not the complexities of the databases. You can create TiDB Cloud clusters to quickly build mission-critical applications on Amazon Web Services (AWS), Google Cloud, and Alibaba Cloud.
[TiDB Cloud](https://www.pingcap.com/tidb-cloud/) is a fully-managed Database-as-a-Service (DBaaS) that brings [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source Hybrid Transactional and Analytical Processing (HTAP) database, to your cloud. TiDB Cloud offers an easy way to deploy and manage databases to let you focus on your applications, not the complexities of the databases. You can create TiDB Cloud clusters to quickly build mission-critical applications on [Amazon Web Services (AWS)](/tidb-cloud/create-tidb-cluster-serverless.md), [Google Cloud](https://docs.pingcap.com/tidbcloud/create-tidb-cluster/), [Microsoft Azure](https://docs.pingcap.com/tidbcloud/create-tidb-cluster/), and [Alibaba Cloud](/tidb-cloud/create-tidb-cluster-serverless.md).

Check failure on line 9 in tidb-cloud/tidb-cloud-intro.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[PingCAP.LyHyphens] ' fully-' doesn't need a hyphen.

Raw Output:
{"message": "[PingCAP.LyHyphens] ' fully-' doesn't need a hyphen.", "location": {"path": "tidb-cloud/tidb-cloud-intro.md", "range": {"start": {"line": 9, "column": 55}}}, "severity": "ERROR"}
Copy link
Member Author

Choose a reason for hiding this comment

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

Note for reviewers: The file name will be updated in another PR. Just ignore the word "serverless" in file names here.


![TiDB Cloud Overview](/media/tidb-cloud/tidb-cloud-overview.png)

Expand Down Expand Up @@ -66,7 +66,7 @@

<!--TBD, ToDo: Not sure the URL for TiDB Cloud Starter-->

- TiDB Cloud Starter
- TiDB Cloud Starter (formerly Serverless)

TiDB Cloud Starter is a fully managed, multi-tenant TiDB offering. It delivers an instant, autoscaling MySQL-compatible database and offers a generous free tier and consumption based billing once free limits are exceeded.

Expand Down
4 changes: 2 additions & 2 deletions tidb-cloud/tidb-cloud-quickstart.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This tutorial guides you through an easy way to get started with TiDB Cloud. You

## Step 1: Create a TiDB cluster

[TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) is the best way to get started with TiDB Cloud. To create a TiDB Cloud Starter cluster, follow these steps:
[TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#tidb-cloud-starter) (formerly Serverless) is the best way to get started with TiDB Cloud. To create a TiDB Cloud Starter cluster, follow these steps:

1. If you do not have a TiDB Cloud account, click [here](https://console.tidb.io/free-trial?provider_source=alicloud) to sign up.

Expand All @@ -26,7 +26,7 @@ This tutorial guides you through an easy way to get started with TiDB Cloud. You
- To create a new TiDB Cloud Starter cluster on your own, follow these steps:

1. Click **Create Cluster**.
2. On the **Create Cluster** page, **Starter** is selected by default. Select the target region for your cluster, update the default cluster name if necessary, select your [cluster plan](/tidb-cloud/select-cluster-tier.md#cluster-plans), and then click **Create**. Your TiDB Cloud Starter cluster will be created in approximately 30 seconds.
2. On the **Create Cluster** page, **Starter** is selected by default. Select the target region for your cluster, update the default cluster name if necessary, select your [cluster plan](/tidb-cloud/select-cluster-tier.md), and then click **Create**. Your TiDB Cloud Starter cluster will be created in approximately 30 seconds.

## Step 2: Connect to your TiDB cluster

Expand Down