Flushing WordPress permalinks is a process that refreshes a website's URL structure. Permalinks must be flushed whenever enabling a new post type or taxonomy. This document will walk you through how to perform this action.
In this document:
- Diagnosing the issue
- Updating the permalinks structure
- How to perform a hard refresh
- How to clear your browser cache
The UW Theme has several post types, such as Publications or Events. When creating a post of a new post type for the first time, the WordPress software may not know how to structure its URL, and the page may display a Page Not Found error.
Performing the steps below will clear the currently saved URL structure and cause WordPress to regenerate the URLs and resolve the Page Not Found error.
- From your WordPress Dashboard sidebar, find the Settings menu and select Permalinks.
- On the Permalinks page, click Save Changes. There are no additional actions needed. Clicking the Save Changes button is all you need to do to trigger WordPress to flush and regenerate the permalinks.
- After flushing your website's permalinks, you may not see the changes take effect until you clear your browser cache or perform a hard refresh. See below for instructions for taking these additional actions.
This process will force the browser to load the most recent changes to the page and ignore any saved/cached files.
- Windows/Linux: Hold down the Ctrl key and press the F5 key on the keyboard
- Mac: Hold down Command and Shift keys and press R on the keyboard
This process will wipe the cookies and files your browser saves. Clearing the cache will force the browser to load the most recent changes to the page. It will also log you out of any currently logged-in websites.