University of Wisconsin–Madison

Flushing Permalinks


per·ma·link
/ˈpərməˌliNGk/

noun

Permalinks are the permanent URLs assigned to pages and posts on your site. These are mostly editable by admins and editors of the site. For example, when you create a page, you have the option to edit the path that this page sits at within the larger domain: https://yoursite.wiscweb.wisc.edu/youcanchangethispart/.


Flushing WordPress permalinks is a process that updates a website’s URL structure. Sometimes, old versions get cached and need to be manually refreshed in order for links on your site to work as expected. Note: this does not happen often but it can happen to any of your sites.

Possible Causes:

  • Development-related update to a custom post type (Fac/Staff, Documents List, Publications, etc.)
  • Changing the Permalink structure site-wide (in your advanced settings)

Warning Signs that Permalinks May Need to be Flushed:

  • “Page Not Found” errors even though you know the page exists
  • Faculty/Staff names are not bringing you to the bio page view when you click on the link.
  • Documents link list items are not opening the document
  • Publications list links are not working

How to Fix: