Purging forces MediaWiki to clear the cached version of a given page, forcing the page to be redisplayed from its source or scripts to restart. It is used to ensure that recent changes are made immediately visible.
A simple way to "purge" a MediaWiki page is to click a page's "View history" tab, then in your browser's location field delete just the word "history" off the end of the URL, type "purge" (after the "=") on the end of the URL, and hit Enter. Your URL should look something like one of the ones below.
- To purge a page, add
?action=purgeto the URL of the page you are viewing. For example:
- If the URL has other parameters in its query string, add the purge action to the query string with an ampersand (&). For example:
example.orgin the above URLs to the host name of your MediaWiki installation.
Requests must be confirmed
Purge requests made via POST are automatically filled. Users making purge requests via a query string will be presented with a confirmation form. This form must be submitted before the purge request will be completed. This behavior is a precaution to keep web spiders from accidentally purging pages when following links.
Purge as a user right
Allows users to purge the site cache for a page without confirmation when the URL parameter "&action=purge" is used.
Purge and image thumbnails
If purge is run on an image description page, the cached thumbnails for the image will be purged.
Purging will only update the rendering of the page, it won't update the link tables. These tables control lists that the page is listed in (For example, pages listed on category pages, Special:Whatlinkshere, along with several other "query" special pages). In order to force an update of the link tables, you can do what is called a null edit. Click on "Edit" and save without changing anything. No entry in the page's history will appear, but all link tables should be refreshed.
An alternative way to update the links table is to use the API's purge module with the
- purgeList.php - a command-line maintenance script that allows batch purging of articles.
- Manual:Performance tuning#Page view caching
- Manual:Parameters to index.php#Actions
- Require POST in ?action=purge
- Help:Locating broken scripts