Settings

July 1, 2025

The Settings page allows you to configure general settings and options for your PlanetScale for Postgres database. To access the settings:

1. From the PlanetScale organization dashboard, select your database
2. Navigate to Settings on the left sidebar menu

General Settings

Database Name

The database name field displays your current database name. This name cannot be changed because it's used to connect to the database. Changing the name would break existing connections and applications.

Default Branch

The default branch dropdown allows you to select which branch serves as the default for your database. This branch will be used as the source when creating new development branches.

To change the default branch:

1. Click the Default branch dropdown
2. Select the desired branch from the list
3. Click Save database settings at the bottom of the page

Restrict Branch Regions

The "Restrict branch regions" option allows you to limit where new branches can be created geographically. When enabled, this setting restricts branch creation to the same region as the default branch only.

To enable region restrictions:

1. Check the Restrict branch regions checkbox
2. Click Save database settings to apply the change

This setting is useful for:

• Compliance requirements that mandate data residency
• Cost optimization by keeping resources in a specific region
• Reducing latency by keeping all branches in the same geographic area

Save Settings

After making any changes to the general settings, click the Save database settings button to apply your changes.

Delete Database

The settings page also provides the option to permanently delete your database. This action is irreversible and will:

• Delete the entire database and all of its branches
• Remove all data and backups permanently
• Disconnect any applications currently connected to the database
• Include usage charges in your final invoice through the deletion date

To delete a database:

1. Scroll to the bottom of the Settings page
2. Click the red Delete database button
3. Enter the database name
4. Click Delete database to confirm

Only Organization Administrators and Database Administrators have permission to delete databases. See the Access Control documentation for more information about user permissions.

Need help?

Get help from the PlanetScale Support team, or join our GitHub discussion board to see how others are using PlanetScale.