Checked-out articles in Joomla: the padlock, and how to release it

An editor opens an article, sees a small padlock next to the title and gets the message that the item is checked out by another user. Nobody is working on it. The colleague in question went home yesterday, or left the company a month ago. The article stays locked until someone with the right permissions lets it go.

The padlock is not a bug and it is not a security feature. It is Joomla's way of stopping two people from editing the same item at the same time and overwriting each other's work. The trouble is that the lock is set when you open an item and only removed when you leave it the right way. Everything else leaves it hanging.

How check-out works

When you open an article, category, module, menu item or contact in the editor, Joomla writes your user ID and the current time into the checked_out and checked_out_time columns of that row. As long as those are filled, other users see the padlock in the list view and cannot open the item for editing.

The lock is released when you leave the editor through one of the toolbar buttons: Save & Close, Save & New or Close. Those buttons run the check-in. Anything that skips them keeps the lock in place:

• closing the browser tab or the whole browser while the editor is open;
• using the browser's back button, or clicking a link in the admin menu instead of Close;
• the session expiring while the editor is open, so the next Save sends you to the login screen;
• a crash, a lost connection or a laptop that goes to sleep halfway through;
• front-end editing where the user navigates away from the edit form.

Plain Save keeps the item checked out, because you are still in the editor. That is intended.

Who has it, and since when

Hover over the padlock in the list view. The tooltip shows the name of the user and the date and time of the check-out. That tells you whether someone is actually working on it right now. A lock from five minutes ago by a colleague who is online is a reason to ask first. A lock from last Tuesday is just a leftover.

Your own locks do not block you. If you checked out an item and closed the tab, you can open it again as usual and leave it properly with Close.

Releasing a single item

Click the padlock icon itself. If you have enough rights, Joomla checks the item in on the spot and the icon disappears. You can also select several items with the checkboxes and use Actions → Check-in in the toolbar.

Whether this works for locks held by other people depends on permissions. Super Users can always do it. Other groups need the right to manage Global Check-in, which you set under System → Global Configuration → Permissions or in the Options of the Global Check-in component. If an editor clicks the padlock and nothing happens, that permission is usually what is missing.

Releasing everything: Global Check-in

Go to System → Global Check-in (in the Maintenance panel). Joomla lists every database table that has a checked_out column, with the number of locked items in each. Select the tables with a count above zero and click Check-in. All locks in those tables are released at once, from every user.

Use it with a little care. If a colleague is editing an article at that moment, their lock is released too. Their work is not lost, but someone else can now open the same item, and whoever saves last wins. On a site with several editors, check with them first or do it outside working hours.

Global Check-in also covers extensions. Many third-party components use the same columns, so a stuck item in a shop, a form builder or an event calendar is often released by the same button.

Making it happen on its own

On a site where locks pile up every week, clicking Global Check-in by hand gets old. Joomla 5 includes a scheduled task for it. Under System → Scheduled Tasks, create a new task and look for the Global Check-in type. You can set a minimum age, so only items locked for longer than a given number of hours are released, which avoids clearing the lock of someone who is editing right now. Check under System → Plugins that the matching task plugin is enabled if the type does not show up.

A daily run with an age of a few hours is a reasonable default. It cleans up the leftovers from closed tabs without getting in the way of real work.

Prevent most locks in the first place

• Tell editors to leave the editor with Close or Save & Close, never with the back button or by closing the tab. This one habit prevents most stuck items.
• Look at the session lifetime under System → Global Configuration → System → Session Lifetime. A very short value logs editors out while they write, which leaves a lock and sometimes loses text. Fifteen minutes is the default; for editors who write long articles, a longer value is friendlier.
• When you block or delete a user account, run Global Check-in afterwards. Locks from a removed user stay behind and only a check-in clears them.

What not to do

You will find advice to clear the columns directly in phpMyAdmin. That works, but it is the slowest and riskiest route: you have to know which tables to touch, the table prefix, and what value the column expects in your Joomla version. Global Check-in does the same thing for every table at once and cannot mistype a WHERE clause. Keep the database for the rare case where you cannot log in to the administrator at all.

If an item is still locked after a Global Check-in, reload the list view first. A padlock that survives a fresh page load means the check-in did not reach that table, which usually comes down to the permission of the account you are using.