Skip to content
    UW Crest
    CALS WordPress Hosting

    University of Wisconsin Madison

    • Support Docs
      • Requesting a Site
      • Planning Your Site
      • Creating Accessible Content
      • Changelog
      • 2015 Theme Docs
    • Contact Us
      • Web Support
      • New Website Request
    • Login
    • CALS Main
    UNIVERSITY of WISCONSIN-MADISON UW-MADISON
    • Login
    • CALS Main

    Dark Mode On

    Your device is set to dark mode so this site is matching that preference. You can click the moon icon to change your site experience.

    • Getting Started
      • Requesting a Site
      • Planning Your Site
      • Setting up Your Site
      • Adding Content to Your Site
      • Creating Accessible Content
      • Best Practices for Maintaining Your Website
    • Tutorials
      • Basic Tutorials
        • Theme Customization Options
        • Logging In
        • Adding/Removing Users
        • Editing Your Site Menu
        • Google Analytics
        • Jump Links
        • Linking Files (PDF, Word, etc.)
      • Advanced Tutorials
        • Improving Site SEO
        • Using Animation
        • E-Commerce & Shopping Cart Options
        • Embed a Google Calendar
      • CALSv4 Migration
        • Getting Started
        • Migrating Content
    • Blocks
      • CALS Blocks
        • Accordion
        • Tabs
        • Card
        • Carousel
        • Modal
        • Posts
        • UW Today Events
      • Core WordPress Blocks
    • Plugins
      • Plugin Guidelines
      • CALS Custom Post Types
      • Resource Directory Block
      • CALS People Directory
      • Protect Pages With NetID
      • Redirection Plugin
      • Broken Link Checker
      • Gravity Forms
    • Web Hosting Guidelines
    • 2015 Theme Docs
    CALSv4 Migration

    CALSv4 Migration – Getting Started

    Our CALSv4 theme offers significant performance, accessibility, and usability improvements over our 2015 (v3) theme. Follow this guide for steps on completing your site migration.

      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.

      Screenshot of CALS 2015 theme
      ⛔️ CALS 2015 Theme (Old)
      Screenshot of new CALSv4 theme
      ✅ CALSv4 Theme (Newest)

      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.

      Not sure how or when to use alt text? Here’s some guidelines to follow

      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.

      Ready to get started?

      Contact Us

      All Support Docs
      ©2026 Board of Regents of the University of Wisconsin System
      Privacy Notice | Non-Discrimination Statement
      Feedback, questions or accessibility issues: websupport@cals.wisc.edu
      Login Request Help Help Docs