Supabase guides

Why Does Supabase Pause? How to Keep a Free-Tier Project Active

Understand why an inactive Supabase project can be paused, how to get it running again, and what developers can do to reduce the risk of future pauses.

Supabase basics6 min readBy SupaPing

In this guide

Practical guidance for developers building and maintaining projects on Supabase's Free Plan.

You deploy a side project, connect your database, and everything works. A few days later, you return to it and discover that the database is no longer responding as expected. If you're using Supabase's Free Plan, project inactivity is one possible explanation.

Supabase can automatically pause Free Plan projects that show insufficient activity over a period of time. This is particularly relevant to prototypes, portfolio projects, demos, and applications that receive very little traffic.

A pause is not the only possible cause of a connection problem, so check your project's status before assuming inactivity is responsible.

Why does Supabase pause projects?

According to the official Supabase project-pausing documentation, Free Plan projects can be considered inactive when they receive too little user database activity over the preceding week. Supabase does this to manage platform resources.

This can affect projects that are technically deployed but receive almost no real usage. For example, an app built for a portfolio or a small experiment might receive only a handful of database requests each week.

The important distinction is that deploying an application does not necessarily mean it generates enough database activity to avoid a pause. The platform evaluates activity, not simply whether your code exists or your frontend is online.

How can you tell whether your project has paused?

  1. Open the Supabase Dashboard and select the relevant project.
  2. Check the project's status and look for any indication that it has been paused.
  3. Review recent project activity and any emails Supabase has sent about inactivity or pausing.
  4. If the project is active, investigate other causes such as incorrect credentials, network problems, API errors, or database connection issues.

Supabase documents warning and confirmation emails for project pausing. Check the current documentation for the latest behaviour and restoration process.

How do you restore a paused Supabase project?

If the project has already paused, follow the restoration instructions in the official Supabase documentation. Supabase currently documents restoring eligible paused projects from the dashboard.

Restoring a project and preventing another pause are different tasks. Once it is running again, consider whether the project receives sufficient database activity for its intended use.

How can you reduce the risk of another pause?

1. Generate real application activity

If people are actively using your application, their database requests can generate activity. For production applications, real user traffic is usually the most natural source of database usage.

2. Review your application's usage

If the project is intended to be used regularly but is receiving almost no requests, investigate why. Check whether the app is being accessed, whether database requests are succeeding, and whether scheduled work is actually running.

3. Consider a scheduled keep-alive mechanism

Developers sometimes use scheduled requests to perform a database operation at regular intervals. The intention is to create database activity even when an application has little natural traffic.

However, not every request is equivalent, and no generic heartbeat should be treated as a guarantee against automatic pausing. Confirm the current platform policy and validate that your chosen operation generates the relevant activity.

4. Consider whether a paid plan is appropriate

Supabase documents that projects on paid plans are not subject to automatic inactivity pausing. If continuous availability is important to your application, compare the current plan features and costs against your requirements.

Can a keep-alive tool help?

A keep-alive tool automates a database operation that would otherwise need to be scheduled and maintained manually. It can be useful for developers who run low-traffic projects and want a repeatable process for generating activity.

SupaPing uses a Vercel Cron Job to call an API endpoint. That endpoint updates a dedicated keep-alive table in the user's Supabase instance. This provides a scheduled mechanism for generating database activity, rather than relying on someone remembering to open the project.

Whether this is sufficient to prevent pausing depends on the applicable Supabase policy and the behaviour of the implementation. Test your setup and monitor it rather than assuming that a successful scheduled run guarantees the project will remain active.

Frequently asked questions

Does Supabase pause every Free Plan project?

No. Supabase describes automatic pausing in terms of insufficient activity. A project receiving enough qualifying activity may not meet the criteria for pausing.

Does opening my website count as database activity?

Only if the visit results in relevant database requests. Loading a static page without accessing the database should not be assumed to generate database activity.

Will a scheduled keep-alive always prevent a pause?

No tool should promise that without validating the relevant platform behaviour. Check Supabase's current policy and ensure the scheduled operation generates the activity that policy recognises.

Where should I check for the latest rules?

Start with the official Supabase project-pausing documentation, as platform policies can change.

Final thoughts

Supabase inactivity pausing is worth understanding if you build low-traffic applications on the Free Plan. Check your project status first, understand what creates database activity, and choose an approach that matches your availability requirements.

If you want to automate a scheduled database update, explore SupaPing and evaluate whether its keep-alive approach is suitable for your project.

Less manual maintenance

Keep your Supabase project on your radar.

SupaPing runs scheduled keep-alive requests that update a dedicated table in your Supabase project. See how it fits your setup and review the approach before relying on it.

Explore SupaPing

Technical behaviour and platform policies can change. Consult the official Supabase documentation linked in this article before making decisions about your production projects.