Skip to content

docs: add Shopify homepage collections section #1520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
reyarqueza wants to merge 1 commit into
base: main
Choose a base branch
from
+22 −0
Open

docs: add Shopify homepage collections section #1520

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,28 @@ Vercel is happy to partner and work with any commerce provider to help them get

> Note: Providers, if you are looking to use similar products for your demo, you can [download these assets](https://drive.google.com/file/d/1q_bKerjrwZgHwCw0ovfUMW6He9VtepO_/view?usp=sharing).

## Shopify homepage collections

The default homepage expects two Shopify collections to exist. Shopify sample data may create products, but it does not always create the exact collections and handles used by this template.

- `hidden-homepage-featured-items`
- `hidden-homepage-carousel`

If these collections do not exist or are not published to your storefront sales channel, the homepage grid and carousel will render empty.

To create them in Shopify Admin:

1. Go to `Products` -> `Collections`.
2. Create a collection for the featured homepage grid.
3. Set its handle to `hidden-homepage-featured-items`.
4. Add at least 3 products to that collection.
5. Create another collection for the homepage carousel.
6. Set its handle to `hidden-homepage-carousel`.
7. Add products to that collection.
8. Make sure both collections are available to the sales channel used by your Storefront API token.

Collections whose handles start with `hidden-` are intentionally excluded from the `/search` collection listing, but they are still used by the homepage.

## Integrations

Integrations enable upgraded or additional functionality for Next.js Commerce
Expand Down