504 Gateway Timeout: why it happens and how to fix it

PlatformAny website Doing it yourself15 to 45 minutes, and some of it is a host ticket Checked

Written and checked by Sajid, Founder & Web Engineer

The short answer

A 504 means the server waited for another part of the system to answer and it took too long, so it gave up. It is a timeout, not a crash: usually one slow operation, a heavy page, a long import, or a database query that runs past the limit. The site itself is fine; something is simply taking longer than the server is willing to wait. Finding the slow operation, and raising the right time limit, clears it.

Is this your problem?

  • A "504 Gateway Timeout" page, often from the server or from Cloudflare
  • It hits a specific heavy page, a search, an export, or the dashboard, not the whole site
  • It appears after a set number of seconds, every time, on that action
  • It started after a big import, a report tool, or a traffic spike
  • Cloudflare shows error 504 with a note that the origin timed out

What usually causes it

1
One slow operation runs past the time limit

How to tell: An import, an export, a report or a bulk action takes longer than the server waits, so the connection is cut.

2
A slow database query

How to tell: A heavy or unindexed query, often from a plugin or a large table, runs long enough to hit the timeout.

3
Too little PHP or server time allowed

How to tell: The max_execution_time or the web-server timeout is set low, so normal-but-slow work is cut off.

4
An external call that hangs

How to tell: The site waits on another service, a payment gateway, an API or an email server, that is slow or down.

5
The server is overloaded

How to tell: Under heavy load everything slows until requests cross the timeout. That is a capacity problem.

Before you touch anything

  • Note exactly which action times out, and whether it is always the same one. A 504 on one page is a slow operation; a 504 everywhere is load or the host.
  • Check whether the error comes from your server or from Cloudflare; the page says which, and it changes where you look.

How to fix it, step by step

  1. 1

    Pin down the slow action

    Find the one page or action that times out. If it is an import or export, that operation is simply too big for one request and needs to run in batches.

  2. 2

    Rule out Cloudflare

    If Cloudflare shows the 504, the origin server is too slow to answer in time. Pause Cloudflare and test directly: if it loads, slowly, the fix is on the server, not Cloudflare.

  3. 3

    Read the server error log

    The PHP or server log shows what ran long: a named plugin, a query, or an external call. That is the thing to speed up or limit.

  4. 4

    Raise the time limits for the slow job

    If a genuine long job needs more time, raise the PHP max_execution_time and the web-server timeout in the host panel. On managed hosting this is a support request. Do this only for work that truly needs it.

  5. 5

    Break big jobs into batches

    Large imports, exports and bulk edits should run in smaller chunks. Many tools have a batch option; use it instead of one giant run.

  6. 6

    Speed up or remove the slow query or call

    If the log names a plugin or an external service, update or replace it, add caching, or remove it. A hanging third-party call should have a short timeout so it fails fast instead of holding the page.

Stop and get help if

  • The log points at the server, the database or the host capacity, which only the host can act on.
  • It is a shop or booking action timing out and losing sales.
  • The slow work is core to the business and needs rebuilding to run in the background, not inside a single request.
Fix it for me

Stop it happening again

  • Run big imports, exports and reports in batches, and at quiet times.
  • Keep the database tidy and queries indexed; watch for a plugin that adds slow queries.
  • Give external calls a short timeout so a slow third party does not hang your pages.
  • Size hosting for your heaviest real task, not only everyday browsing.

Questions people ask

Is 504 the same as 502?

No. 504 means the upstream took too long, a timeout; 502 means it sent back a broken reply. The causes overlap but a 504 is about time.

Why only on one page?

That page runs a slow operation, a big query or a heavy export, that crosses the time limit. The rest of the site answers in time.

Will raising the timeout fix it for good?

Only if the work genuinely needs the time. If the real cause is a slow query or an overloaded server, more time just delays the same problem; fix the cause as well.

Not sure where your site stands?

Paste the address. Security, speed, SEO and how old the tech is, in about ten seconds.

Still broken? We can fix it.