Do I need to migrate my site?
The short answer is “Yes”. If your site uses our old 2015 (v3) theme, or is using a non-UW vendor theme, you will need to migrate your site to your newest CALS v4 theme that uses the Gutenberg. CALS Web Services is working through migrating sites, and will reach out when it is time for you to migrate. However, we are happy to help you migrate at anytime, so please reach out if you would like to migrate your website. If you are interested in migrating as soon as possible, take a look at the features and documentation available for our new theme, and contact us when you are ready to migrate.


Preparing for Migration
Site clean up is an important task that every site editor/owner should do every year. Deleting old media (images/pdfs), pages and posts that are not being used or that are duplicates helps keep your site managable, and can also speed up your site, particluarly if it has lots of old content laying around. This old and unused content can bog down the database and make your website slower since there is more stuff for it sift through every time your website loads.
Clean up is also an important first step in the migration process. It will save you time to not have to migrate content that you are not using, and again will also provide you with a leaner, faster website after migration.
Clean up your pages and posts
This is a great time to delete old pages and posts that are no longer needed.
- Delete pages that you no longer need or that are in “draft” state. If a post is old and in draft state, and you determine that it is not needed.
- It is also a great time to delete old posts that are no longer relevant, since post content is often ephemeral, such as announcements, events, etc. Old posts can often be deleted if they’re no longer relevant, timely, or accurate.
Clean up your user list
Take a look through your user list by visiting Users > All Users from the admin panel of your site. Make sure everyone nobody has access to your site who should not, such as previous students who have since graduated or old staff members.
Clean up media libary
Visit your media library by visiting Media from the admin panel of your site. If there are photos you know are not on a page, you can delete them. Unfortunately, the Media interface in WordPress leaves a lot to be desired. It will not be able to accurately indicate whether an image is actually used on a page. You should also take a look at the list view (by clicking the icon in the top left) to see which images are missing alt text. If an image is missing alt text within the media library, it doesn’t necessarily mean it is missing alt text on the page, as these are controlled independently. However, setting alt text from the media library (and in the uploader whenever you add a new image) is a great habit since the alt text will then be automatically used when the image is added to any page.
Learn how to use the block editor
Make sure you’re prepared to use the block editor interface by reviewing our resources and training videos. We’re also available for one-on-one training sessions.
Learn how to make your content accessible
Make sure you’re familiar with UW-Madison digital accessibility initiative and requirements so you can check pages for accessibility as you migrate content over to the block editor. See our CALS documentation for a tutorial on how to make your WordPress page content accessible.