This guide is designed to explain how Project Pages URLS work, how you can change them, and what to do if they’re not loading. (Assumes Project Pages WordPress plugin v2.0+.)
Default URLS #
By default your Project Pages will be served from your site on an URL like this:
https://yourdomain.com/projects
https://yourdomain.com/projects/time-machineIn the above example, projects is what I call your Permalink Root. All Project Pages pages will start with it. For example, Project Tag archives would look like this:
https://yourdomain.com/projects/tagged/woodwork/If you’d like to change this structure, you can start by changing the Permalink Root:
Permalink Root #
As above, this defaults to /projects but you can use any text string you’d like (Note, it will be slug-ified – e.g. My 3PIC Project$ would become my-3pic-project).
To change your Permalink Root from projects:
1. Head over to your Project Pages Settings page, (with Project Pages installed click ‘Project Pages’ – > ‘Settings’ from your wp-admin screen).
2. From there find the ‘URLS’ section of settings. Here you can change the Permalink root to any text string, then click ‘Save Settings’:
On saving you should be able to click the link below the new Permalink Root that you’ve set to verify your Project Page archive is loading. (E.g. in the above example /le-projects.) If it doesn’t load, see the following section of this guide.
Troubleshooting: Refreshing Permalinks #
Permalinks are a beautiful feature in WordPress. They’ve made our websites prettier in the URL bar for years now, but they do still sometimes hit an issue when we change the rules which work them behind the scenes.
If you’re loading your Project Pages pages and they’re 404’ing, or not showing properly, you may need to ‘refresh’ or ‘flush’ your permalinks. Here’s how:
1. Go to ‘Settings’ -> ‘Permalinks’ from your wp-admin menu:
2. Don’t. Change. Anything. Just click ‘Save Changes’ at the bottom of the page:
3. Test your Permalinks:
It’s always good practice to check over your site after you update the permalink structure, (though in reality what we’re doing here is ‘flushing’ the rules to rebuild it – nothing bad should have happened, but hopefully your Project Pages are working now!)
Note: Project Pages does it’s best to do this all behind the scenes when you change the Permalink root, sometimes however, with caching, or many permalink changes, these get lost in the mix. Flushing your permalinks like this is almost always the fix.
