Taking over the home page

PageStax can show one of your pages as your store's home page — the page at your store's main address (/). Because this means editing your theme, PageStax is careful: it backs up your theme's original homepage first and can put it back exactly as it was.

Create a home page#

1. In Pages, press Create page and choose Home page.
2. Pick a template. Only templates that have everything a home page needs — a header, a hero, a product range and a footer — are listed, and your new page starts with just those sections (plus a story or benefits block when the template has one). The product range shows your real products.
3. Name it and press Create & open in editor.

It stays a draft until you publish it.

Turn an existing landing page into your home page#

In Pages, select the landing page and press Make home page in its panel. To go back, select the home page and press Make landing page (a home page that is live on your store has to be unpublished first).

You can have one home page per store. If you already have one, PageStax tells you which page it is — make that one a landing page first. Once a page is marked, the Pages list shows a Home filter, and publishing it always goes to the home page — never to a landing page.

The psx command-line tool does the same with psx compose --kind home --brief "…" and psx pages set-kind --page "My home page" --kind home. See The psx CLI quick start.

Publish it#

1. In Pages, press Replace homepage on the page's card (or open it and press Publish; the only target is Home).
2. Read the confirmation — Replace your homepage with "…"? — and confirm.

What happens, in order:

1. PageStax reads your published theme's homepage files and stores a copy. If that copy can't be stored, nothing on your theme changes.
2. It adds its own homepage file to the theme, then removes the theme's index.json so its file is used.
3. Your store's main address now shows your PageStax page.

Publishing again, or publishing a different page as home, only changes which page is shown. The original backup is never overwritten.

Put the original back#

Unpublish the home page — Unpublish in the editor's publish window, or psx pages unpublish. PageStax writes the stored files back exactly as they were, removes its own file, checks the result, and only then deletes the backup.

If you edit the homepage in the theme editor#

If someone changes the theme's homepage in Shopify's theme editor after the takeover, PageStax won't overwrite that work. Both publishing and unpublishing stop with a message saying the homepage changed, and nothing is touched.

Requirements and limits#

• Replacing the homepage edits your theme's files, which Shopify only allows some apps to do. If Shopify doesn't allow it for your store, publishing stops with a message and your theme is unchanged.
• PageStax takes over the theme that is published at the time. If you later publish a different theme in Shopify, that theme shows its own homepage; unpublishing in PageStax still restores the original on the theme it was taken from.
• PageStax's home page is a full page of its own, so theme app embeds (including the PageStax cart drawer) don't run on it.