You just launched an update on your WordPress site. Everything seems fine. You wait a few seconds. Then you refresh the page…
And then, panic.
A blank screen. A cold message: “Briefly unavailable for scheduled maintenance. Check back in a minute.”
You wait one minute. Two minutes. Five minutes. Nothing changes. You refresh again and again. The message stays there, relentless. Your site has become inaccessible. Your heart races. “Did I break everything?”
If you’re reading this article, you’re probably in this situation right now. Take a deep breath. Everything will be fine.
This problem is one of the most common on WordPress, and the good news? In 99% of cases, it’s fixed in 2 minutes flat. You didn’t break anything. Your content is intact. Your visitors won’t see anything. We’ll unlock this together, step by step.
Sommaire
- ⥠In a Hurry? The Express Solution
- đ€ Why This Message Appears (and Why It Won’t Go Away)
- ⥠Quick Solution: Unlock Your Site in 2 Minutes
- đ° Still Not Working? Solutions for Difficult Cases
- đĄïž How to Prevent This From Happening Again
- â Frequently Asked Questions
- đŻ Summary: Unlock Your WordPress Site at a Glance
- đȘ You Did It!
⥠In a Hurry? The Express Solution
Your site displays the maintenance message and refuses to return to normal? In most cases, you just need to delete a small file named .maintenance that got stuck on your server. Jump directly to the Quick Solution section to fix this in 2 minutes.
đ€ Why This Message Appears (and Why It Won’t Go Away)
What Normally Happens
When you update WordPress (the core, a plugin, or a theme), here’s what happens behind the scenes:
- WordPress creates a small hidden file named
.maintenanceat your site’s root - This file signals: “I’m under maintenance, show the waiting message to visitors”
- The update proceeds (downloading and installing new files)
- WordPress automatically deletes the
.maintenancefile - Your site becomes accessible again, as if nothing happened
Normal duration of this process: Between 5 and 30 seconds maximum.
It’s a smart mechanism! During those few seconds, your visitors see a polite message rather than a half-functioning site.
So What Went Wrong?
The problem occurs when the update is interrupted before completion. WordPress didn’t have time to delete the .maintenance file, and this file continues to block access to your site.
The usual culprits:
- You closed the tab too early: The classic reflex. The page seems frozen, you close the tab… and the process is cut short
- Your internet connection hiccuped: A micro-outage of a few seconds is enough to interrupt everything
- Your hosting is a bit slow: The server took too long to respond, and the update script “timed out”
- You launched multiple updates at once: Clicking “Update All” can overload your server
- A plugin misbehaved: Sometimes a plugin conflicts during its own update
đĄ Did You Know?
This .maintenance file starts with a dot, making it invisible by default in most interfaces. That’s why we don’t see it when trying to figure out what’s wrong!
Is It Serious? Did I Lose Data?
No, don’t worry! This block is superficial:
- â Your content (posts, pages, comments) is intact
- â Your media (images, videos) are still there
- â Your database hasn’t been touched
- â Your WordPress settings are preserved
What’s happening: WordPress is simply displaying a “do not disturb” message to all your visitors (including you). Once the file is deleted, everything will return to normal instantly.
⥠Quick Solution: Unlock Your Site in 2 Minutes
Ready? You’ll see, it’s much simpler than you think. You just need to manually delete that famous .maintenance file that got stuck.
You’ll need:
- Access to your hosting (via your host’s interface OR via FTP software)
- 5 minutes of concentration
- A bit of courage (you can do this!)
Two methods to choose from (pick the one that seems simpler to you):
Method 1: Via Your Host’s Interface (cPanel, Plesk…)
đ This method is ideal if: Your host gives you access to a file management interface (most do). At Bluehost, SiteGround, HostGator, GoDaddy… it’s usually called “cPanel” or “File Manager”.
Step 1: Log in to Your Hosting Interface
Depending on your host, you can access cPanel in different ways:
- Via direct URL: Type
https://your-site.com:2083in your browser - Via your host’s client area: Look for a “Hosting” or “File Management” section
- Via the welcome email you received when signing up (search for “cPanel” in your emails)
Once logged in, you’ll arrive at a dashboard that looks like this:
Interface with lots of colorful icons representing different functions (emails, databases, files…)
Step 2: Find the “File Manager”
Look for an icon or button called:
- “File Manager”
- “Files”
- “Web Files”
Click on it. A new window or tab opens.
Step 3: Go to Your WordPress Site’s Root
In the file manager, you’ll see a list of folders. Look for the folder containing your WordPress site. It’s usually named:
public_html(most common)wwwhtdocs- Or sometimes your domain name
How to be sure it’s the right folder? It should contain subfolders named wp-admin, wp-content, and wp-includes. If you see them, you’re in the right place! đŻ
Step 4: Show Hidden Files
â ïž CRUCIAL STEP: By default, files starting with a dot (like .maintenance) are invisible.
You need to enable their display:
- Look for a “Settings” button (often top right or in a menu)
- Check the option “Show hidden files” or “Show dotfiles”
- Validate
Now look at the file list again. You should see files that weren’t there before, including .htaccess and… .maintenance!
Step 5: Delete the .maintenance File
You see it now? Perfect! Final stretch:
- Click on the
.maintenancefile to select it - Right-click (or look for a “Delete” button)
- Choose “Delete”
- Confirm when asked
Done! The file is gone.
Step 6: Verify Your Site Is Back
Moment of truth! Open a new tab (or use private browsing) and go to your site.
If all goes well: Your site displays normally! đ The maintenance message is gone. You can breathe.
If it doesn’t work: Don’t panic, go to the “Still Not Working?” section below.
â Congratulations, You Did It!
You just solved your first WordPress technical problem. Next time (let’s hope there isn’t one!), you’ll know exactly what to do.
Method 2: Via FTP Software (FileZilla…)
đ This method is ideal if: You don’t have cPanel access, or you prefer using dedicated software. It’s slightly more technical but just as effective.
Step 1: Download and Install FileZilla (if not already done)
FileZilla is free software that lets you access your site’s files. It’s like a “file explorer” but for your website.
- Go to filezilla-project.org
- Download the “FileZilla Client” version (free)
- Install it on your computer
Alternatives: Cyberduck (Mac), WinSCP (Windows) work great too.
Step 2: Get Your FTP Credentials
To connect to your site, you need 3 pieces of information. You’ll find them:
- In your host’s **welcome email** (search for “FTP” in your emails)
- In your host’s client area (FTP or “FTP Access” section)
The 3 pieces of information you need:
- Host / Server: often
ftp.your-site.comor just your domain name - Username: your FTP login
- Password: your FTP password
Step 3: Connect with FileZilla
Open FileZilla. At the top of the window, you’ll see empty fields:
- In “Host”: type your FTP server
- In “Username”: your FTP username
- In “Password”: your FTP password
- In “Port”: leave empty (or enter 21)
- Click “Quickconnect”
FileZilla connects… and after a few seconds, you’ll see your files appear in the right side of the window!
Step 4: Find Your WordPress Site’s Root
In the right side of FileZilla (“Remote site” section), navigate to your site’s folder. Look for the folder containing wp-admin, wp-content, wp-includes.
It’s usually in a folder named:
public_htmlwwwhtdocs
Step 5: Show Hidden Files
On FileZilla:
- “Server” menu (at top)
- Click on “Force showing hidden files”
On Cyberduck:
- “View” menu
- Check “Show hidden files”
The file list refreshes, and you now see additional files, including .maintenance.
Step 6: Delete the .maintenance File
- Locate the
.maintenancefile in the list - Right-click on it
- Choose “Delete”
- Confirm
FileZilla deletes the file. Done!
Step 7: Check Your Site
Open your site in a new tab (private browsing if possible). The maintenance message should be gone! đ
đš The .maintenance File Still Doesn’t Appear?
Make sure you’ve enabled hidden files display. That’s the most common mistake! Without this option, the file will stay invisible even though it’s there.
đč Video: See the Process Live
Prefer to watch someone do it before trying? Here’s a video showing the entire procedure step by step:
Feel free to pause the video and follow at your own pace. Take your time, there’s no rush.
đ° Still Not Working? Solutions for Difficult Cases
You deleted the .maintenance file, but your site is still blocked or showing an error? Don’t worry, we have other cards up our sleeve.
Before continuing: If possible, make a backup of your site (files + database). Better safe than sorry!
Solution 1: Temporarily Disable All Your Plugins
Why do this? Sometimes an updated plugin generated an error that’s blocking your site. By disabling them all at once, we can identify if that’s the problem.
How to do it:
- Connect via FTP or file manager (as we saw above)
- Go to the
wp-contentfolder - See a folder named
plugins? Rename it toplugins-disabled - Go back to your site and refresh
If your site works: Bingo! The problem comes from a plugin. Rename the folder back to plugins, log in to your WordPress dashboard, and reactivate your plugins one by one to find the culprit.
If nothing changes: Rename the folder back to plugins and move to the next solution.
Solution 2: Test with WordPress Default Theme
Why do this? More rare, but your theme could also be the cause.
How to do it:
- Via FTP or file manager, go to
wp-content/themes - Rename your active theme’s folder (for example:
my-themebecomesmy-theme-old) - WordPress will automatically switch to a default theme (like Twenty Twenty-Five)
- Refresh your site
If your site works: The problem comes from your theme. Contact the theme support or try reinstalling it.
If nothing changes: Rename your theme back to its original name and move to the next solution.
Solution 3: Clear Cache (Browser + WordPress)
Sometimes the site is back to normal but your browser is still showing the old “cached” version.
Clear Browser Cache:
- Chrome / Edge: Ctrl + Shift + Delete (Windows) or Cmd + Shift + Delete (Mac)
- Firefox: Ctrl + Shift + Delete
- Safari: Cmd + Option + E
Check “Cached images and files” and click “Clear data”.
Clear WordPress Cache:
If you’re using a cache plugin (WP Rocket, W3 Total Cache, WP Super Cache…):
- Try accessing your WordPress dashboard
- Find your cache plugin in the menu
- Click “Clear cache” or “Purge cache”
Solution 4: Ask Your Host for Help
If nothing works, don’t hesitate to contact your host’s support. They’re used to this kind of problem and can intervene quickly.
What to tell them:
“Hello, my WordPress site is displaying the ‘Briefly unavailable for scheduled maintenance’ message and staying blocked. I tried deleting the .maintenance file but the problem persists. Can you help?”
Most of the time, they’ll solve the problem in a few minutes.
đĄïž How to Prevent This From Happening Again
Now that your site is back, let’s talk prevention. A few simple actions can save you from reliving this moment of panic.
1. NEVER Close the Tab During an Update
The golden rule. This is the #1 cause of the problem.
When WordPress tells you “Update in progress…”, let it do its thing. Even if it takes time. Even if the page seems frozen. Wait for the “Update complete” message before closing anything.
How long does it take?
- A small plugin: 10-30 seconds
- WordPress itself: 30 seconds to 1 minute
- A large plugin (WooCommerce, Elementor…): up to 2 minutes
If after 5 minutes nothing moves, there’s probably an issue. But give it time!
2. Update One Thing at a Time
We’re tempted to click “Update All” to save time. But it’s risky.
Better to:
- Update plugin by plugin
- Wait for each update to complete
- Check that the site works between each update
Advantage: If a problem occurs, you’ll know exactly which update caused it.
3. Make Regular Backups
Backup is like insurance: you don’t see the point… until the day you need it.
Recommended free plugins:
- UpdraftPlus: Easy to use, backs up to Google Drive, Dropbox…
- BackWPup: Very complete, automatic backup
Set up automatic backups:
- Daily for a site with lots of activity
- Weekly for a quieter site
- Keep at least 7 days of backups
That way, if something really goes wrong, you can always restore a working version.
4. Check Compatibility Before Major Updates
WordPress regularly releases new versions. Before updating to a major version (for example, from 6.4 to 6.5), take 5 minutes to check that your main plugins are compatible.
How to check:
- Go to the plugin’s page in the WordPress directory
- Look at the “Tested up to…” section
- If it says “Tested up to WordPress 6.5”, you’re good to go
5. Choose Quality Hosting
Low-end hosting = slow server = updates that crash often.
Signs of inadequate hosting:
- Your site is often slow
- Updates take forever
- You regularly get 500 errors
If that’s your case, consider changing hosts. A few extra dollars per month can save you hours of hassle.
â Frequently Asked Questions
Can the .maintenance File Come Back on Its Own?
No, not spontaneously. It only recreates during a new WordPress update. If you delete it and it reappears, it means an update was relaunched (manually or automatically).
Do I Risk Breaking My Site by Deleting This File?
No, no risk! This file is only there to display the maintenance message. Deleting it doesn’t touch your content, settings, or plugins. It’s totally safe.
Why Does This File Start with a Dot?
On servers (Linux/Unix), files starting with a dot are considered “system files” and are hidden by default. This prevents them from being accidentally deleted. But in our case, that’s exactly what we want to do!
Can My Host Delete This File for Me?
Yes! If you’re really not comfortable with the process, contact your host’s support. Explain the problem, they’ll delete the file in a few minutes. It’s a common issue for them.
How Long Can the Message Stay Displayed?
Indefinitely. The .maintenance file won’t disappear on its own. It must be manually deleted. I’ve seen sites stay blocked for days because the owner was waiting for it to “fix itself”.
Do My Visitors See the Same Message as Me?
Yes. Everyone (including you) sees the maintenance message. Nobody can access the site as long as the file is present. That’s why you need to act quickly!
Can WordPress Automatic Updates Cause This Problem?
Yes, but it’s rarer. WordPress does automatic updates for minor versions (for example from 6.4.1 to 6.4.2). If your server is slow or the connection is unstable, it can get stuck. Hence the importance of having good hosting.
đŻ Summary: Unlock Your WordPress Site at a Glance
| Problem | Solution | Time |
|---|---|---|
| Stuck maintenance message | Delete .maintenance file | 2 min |
| Site still blocked after deletion | Disable all plugins | 5 min |
| Still nothing | Test with default theme | 3 min |
| Still not working | Clear all caches | 2 min |
| Still blocked | Contact your host | 10-30 min |
đȘ You Did It!
If you’re reading these lines, your site is probably back online. Congratulations! đ
You just solved one of the most common WordPress problems. Next time (let’s hope there isn’t one), you’ll know exactly what to do. You won’t panic anymore. You’ll go straight to the point.
What you learned today:
- â How WordPress maintenance system works
- â How to access your site’s files (via cPanel or FTP)
- â How to display and delete hidden files
- â How to react when the simple solution isn’t enough
- â How to prevent it from happening again
You’re now a bit more autonomous with your site. And that’s valuable.
One last thing: If this article helped you, share it! Someone else might be panicking with the same message on their screen right now. You could save their day. đ
đŹ How Did It Go For You?
Tell us in the comments:
- Did you manage to unlock your site?
- Which method did you use?
- Did you encounter any other difficulties?
Your feedback helps other visitors in the same situation!




