Step 7: Common Upgrade Issues

Remember, the Community is a great place if you have any questions about upgrades or issues doing your own upgrade! Start by searching the Community for the error - others may have run into it before and posted a solution. If you can’t find your specific issue, feel free to post in the Community yourself and someone will help you debug it. Including screenshots of your console errors (both in the Code Editor and Live Preview) will help us help you!

Live Preview console errors show “Error updating component” + “Caused By: [Item] could not be found”.

Solution: Make sure to update to the latest SDK in the global_config.json file. This is erroring because the Hitchhiker Theme is trying to reference Search UI SDK components that are not available in the version of the Search UI SDK currently being used in the Search experience. Once you manually update the version number, be sure to click Restart Live Preview.

Live Preview showing no results for "Events" query and console errors

Changes don’t show up on the master branch after you merged the theme upgrade into the master branch.

Solution: Check the recent commits on the master branch include a “Force Merge Branch” commit and any new commits made to the theme upgrade branch you merged into master. If these exist, terminate the session when you click into the master branch and start a new session. If these don’t exist, merge the theme upgrade branch into master.

Code Editor branches screen with master branch selected and showing new commits

Solution: Be sure to hard refresh the page you’re looking at to pull in the changes. Hard refresh by pressing command + shift + R on a Mac or control + F5 on Windows. This clears the cache on the page, which could display a previous version of the page instead of the updated one with your changes.

Feedback