<% user.full_name %>
<% util.level ? util.level.title : '' %>
Explorer Pioneer Apollo Viking Voyager Pathfinder Orion
Points
<% user.points ? user.points.toLocaleString() : 0 %>
Badges
<% util.badgeCount %>
Streaks
Congratulations You've <% util.newestBadge.isCurriculum ? 'completed' : 'earned' %> the
<% util.newestBadge.title %> <% util.newestBadge.isCurriculum ? 'curriculum' : 'badge' %>!
previous
next
Share to Social Media
Linked In Facebook
Status
<% util.level ? util.level.title : '' %>
<% util.level ? util.level.points : '' %>
<% util.nextLevel ? util.nextLevel.title : '' %>
<% util.nextLevel ? util.nextLevel.points : '' %>
Level up! <% util.levelPointsRemaining %> points to go
Level up! <% util.levelPointsRemaining %> points to go
Badges
Completed Hitchhikers Program Track Completed Content Track Completed Pages Track Completed Page Builder Track Completed Search Backend Track Completed Search Frontend Theme Track Completed Search UI React Track Completed Solution Templates and the Admin Console Track Completed Technical Skills Track Completed Platform Basics Track Completed Listings Track Completed Reviews Track Completed Industry Overview Track Completed Analytics Track Completed Industry Overview & Product Basics Track Completed Knowledge Assistant Track Completed Multi-Language Experiences Track Completed Fall '22 Release Highlights Track Completed Spring '23 Release Highlights Track Completed Chat Track Completed Summer '23 Release Highlights Track Completed Fall '23 Release Highlights Track
<% util.expandBadges ? 'Less' : 'More' %>
Playground Accounts
New +
No Playground Accounts
Create Playground +
View Profile
Log Out loading
Mission Complete! 🚀
Congratulations, you’ve completed your first module!

We hope you enjoy exploring the rest of the site. Please don’t forget to leave us feedback - we are constantly looking to improve. Happy Hitchhiking!
Home
Welcome to Hitchhikers! 👋
To learn more about the platform we encourage you to get started by completing the Hitchhikers Program Track and earning your first badge!
Start Here
Close notification
< DOCS HOME
Search
Pages
No results in this galaxy.
Try searching all of Hitchhikers here.
Getting Started
Types of Pages
Development Dependencies
Development Dependencies (< PagesJS 1.0.0)
Super Quick Start
Pages Product Architecture
Pages Reference
Upgrading to PagesJS 1.0.0
Repo Structure
Repo Structure (< PagesJS 1.0.0)
Templates
Types and Interfaces
Typescript Interface Generation
Site Configuration
Site Config Files (< PagesJS 1.0.0)
CI Configuration (< PagesJS 1.0.0)
Site Settings
HTTP Serverless Functions
HTTP Serverless Functions (< PagesJS 1.0.0)
Global Data
Global Data (< PagesJS 1.0.0)
Paths and Slugs
Environment Variables
Environment Variables (< PagesJS 1.0.0)
Data Fetching
Styling
Images
Client-Server Templates
Rendering Rich Text and Markdown
404 Page
Sitemaps
Sitemaps (< PagesJS 1.0.0)
SEO Best Practices
Previewing Content Updates
Third-Party Analytics
Robots.txt
URL Routing
System-Generated Redirects
Redirects (< PagesJS 1.0.0)
Authentication
Domain Configuration
Reverse Proxy
Multiple Language Support
Pure JS Rendering
Directory Management
Site Backups
Plugins
Website "Fleet" Management
Yext Pixel and Cookies in Pages Product Offerings
Relationships in Pages
Troubleshooting Tailwind Issues in PagesJS 1.0.0
home

Upgrading to PagesJS 1.0.0 | Yext Hitchhikers Platform

If you are using a beta version of PagesJS (anything below version 1.0.0), we recommend upgrading your project ASAP to take advantage of the latest features!

book
Note
Ensure you have the latest version of the Yext CLI installed before proceeding with the steps below (at least 0.1_382 or higher).

To help facilitate this, Pages offers an upgrade command that will update any necessary portions of your project automatically.

To get started, cd into your project and run the following command:

npx @yext/pages@latest upgrade

This command will perform the following actions automatically:

  1. Logs a warning if you’re using the legacy markdown component from react-components and links to the reference doc on  Rendering Rich Text and Markdown

  2. Updates the following dependencies to latest:

    • @vitejs/plugin-react
    • vite  (to latest Vite 5)
    • @yext/search-headless-react
    • @yext/search-ui-react

  3. Removes fetch imports if it’s coming from @yext/pages/util (as it is supported natively as part of node.js 18 )

  4. Adds/updates the following package.json scripts: dev, prod, build

  5. Updates node engines in package.json to ^18.0.0 || >=20.0.0

  6. Checks the current version of node the user is on and errors if not on 18 or 20

  7. Updates @yext/pages to the version of the upgrade script running (should be the latest)

  8. Removes the following dependencies from package.json and updates imports to use @yext/pages-components  instead

    • @yext/sites-components
    • @yext/react-components

  9. Installs dependencies based on the package manager you’re using (npm, pnpm, yarn)

  10. Migrates from sites-config files (refer to the Site Config Files (< PagesJS 1.0.0) reference) to the new consolidated config.yaml format (refer to the Site Configuration reference doc)

book
Note
As a best practice, we recommend performing this upgrade on a separate branch and testing a deployment in the platform before merging into your production branch.

For a list of features and bug fixes introduced in PagesJS 1.0.0 and each beta version, check out this Github changelog .

Back
< Pages Product Architecture
Next
Repo Structure >
Feedback
<% elem.innerText %>