Training Manual

vercel/commerce

Generated by Inkwell Forge — automated codebase documentation analysis. Based on analysis of 5 screens. Subject matter expert review is recommended before distribution.

May 5, 2026

Commerce Application

Training Manual

Date: May 2026


Generated by Inkwell Forge — automated codebase documentation analysis. Subject matter expert review is recommended before distribution.



About This Document

This Training Manual covers 5 screen(s) of the Commerce application.

Screens covered in this document:

Screen Name Route
Home /
Item Detail /[page]
Product Detail /product/[handle]
Search /search
Search Detail /search/[collection]

Screens and features not included in the assessed documentation are outside the scope of this document.

Note: This document reflects a partial view of the application. The screens assessed here represent the public-facing storefront browsing experience. Key functional areas — including the shopping cart, checkout process, account management, and any administrative interfaces — were not part of this assessment and are therefore not covered. Additional screens should be assessed for comprehensive coverage.



How to Use This Manual

Structure of This Manual

This manual is organized as a guided learning journey. You will work through it from beginning to end, building skills progressively. Here is how the pieces fit together:

Manual
 └── Foundation Skills   ← Shared controls you'll use everywhere
 └── Modules             ← End-to-end workflows
      └── Lessons        ← One discrete skill per lesson
           ├── What You'll Learn
           ├── Before You Begin
           ├── Walkthrough       ← Step-by-step instructions
           ├── Try It Yourself   ← Your practice exercise
           ├── Knowledge Check   ← Self-assessment questions
           └── Tips & Gotchas    ← Practical advice
 └── Capstone Exercise   ← A realistic scenario combining multiple modules

Start with Foundation Skills. These teach the shared controls — product grids, carousels, sort options, and product tiles — that appear throughout the application. Learning them once here means you won't need to re-learn them in every lesson.

Work through Modules in order. Each module builds on the previous one. Module 1 orients you to the store; Module 2 teaches you how to find products; Module 3 teaches you how to evaluate them; Module 4 covers informational pages.

Complete the Capstone Exercise last. This is a realistic scenario that combines skills from multiple modules. You should complete it without step-by-step guidance — just a goal and success criteria.

Estimated Total Time

Section Estimated Time
Foundation Skills (4 skills) 25–35 minutes
Module 1: Orienting Yourself in the Store 20–30 minutes
Module 2: Discovering Products 40–55 minutes
Module 3: Evaluating a Product 35–50 minutes
Module 4: Reading Informational Pages 20–25 minutes
Capstone Exercise 20–30 minutes
Total ~2.5–3.5 hours

You do not need to complete the manual in a single session. Each lesson is self-contained — you can stop after any lesson and pick up where you left off.

Tracking Your Progress

At the end of this manual, you will find a Skills Checklist. After completing each lesson, return to the checklist and tick off the skills you have practiced. This gives you a clear picture of what you have covered and what remains.



Prerequisites

Before starting this training, make sure you have the following:

Note: Adding items to a cart and completing a purchase may require additional steps not covered in this document. Consult your system administrator for guidance on those workflows.



Foundation Skills

Before diving into the training modules, this section teaches you the shared controls and patterns that appear throughout the application. Completing these foundation skills first will make every subsequent lesson faster and easier.


FS-1: Working with Product Grids

What It Is

A product grid is a layout that displays multiple products side by side in rows and columns. You will encounter product grids on the Search screen, the Search Detail (collection) screen, and anywhere the store displays a list of products. The grid automatically adjusts the number of columns based on your screen size — on a phone you see one column, on a tablet two columns, and on a desktop three columns.

[Screenshot: A product grid showing 6 product tiles arranged in 3 columns on a desktop screen]

How to Interact with a Product Grid

Scanning the grid:

Clicking a product:

  1. Locate the product tile you are interested in.
  2. Click anywhere on the tile — the image, the title, or the price area.
  3. You will be taken to that product's detail page.

Returning to the grid:

Practice Exercise

  1. Navigate to the store's Search screen (your trainer or system administrator can provide the URL).
  2. Without entering a search term, observe the product grid that appears.
  3. Count how many columns are visible on your screen.
  4. Click on any product tile.
  5. Confirm that you are taken to a product detail page.
  6. Press your browser's Back button.
  7. Confirm that you are back on the product grid.

Knowledge Check

Tips


FS-2: Working with Product Carousels

What It Is

A product carousel is a horizontally scrollable row of product tiles. Unlike a grid, a carousel does not wrap into multiple rows — it extends sideways, and you scroll left or right to see more products. You will encounter the carousel on the Home screen, where it displays a broader selection of products below the featured grid.

[Screenshot: A product carousel showing several product tiles in a single horizontal row, with partial tiles visible at the right edge indicating more content]

Scrolling through the carousel:

Clicking a product:

  1. Scroll the carousel until you can see the product you want.
  2. Click on the product tile.
  3. You will be taken to that product's detail page.

Practice Exercise

  1. Navigate to the store's Home screen.
  2. Scroll down past the featured product grid until you see the carousel.
  3. Scroll the carousel to the right to reveal at least two products that were not initially visible.
  4. Click on one of the newly revealed product tiles.
  5. Confirm that you are taken to a product detail page.
  6. Press your browser's Back button to return to the Home screen.

Knowledge Check

Tips


FS-3: Understanding Sort Options

What It Is

Sort options let you control the order in which products appear in a grid. You will encounter sort controls on the Search screen and the Search Detail (collection) screen. Changing the sort order does not remove any products — it simply rearranges them.

The available sort options are defined by the store and typically include choices such as relevance, price (low to high), price (high to low), newest arrivals, and best-selling items.

How Sort Options Work

Sort options are applied by selecting a value from a sort control — typically a dropdown or a set of links — that is part of the page's navigation or filter area. When you select a sort option:

  1. The URL updates to include a ?sort= parameter (for example, ?sort=price-asc).
  2. The page reloads with the products reordered according to your selection.
  3. The product grid displays the same products in the new order.

Important: If you navigate away and return, the sort order you selected will still be active as long as the URL still contains the ?sort= parameter. If you share or bookmark the URL, the sort order is preserved.

Default sort: When no sort option has been selected, the store uses its default sort order (typically relevance or best-selling). You do not need to select a sort option — the page always displays results in some order.

Unrecognized sort values: If a URL contains an unrecognized sort value, the store silently falls back to the default sort order. You will not see an error message.

Practice Exercise

  1. Navigate to the store's Search screen.
  2. Observe the current order of products in the grid.
  3. Locate the sort control (ask your trainer if you cannot find it).
  4. Select a sort option that orders products by price from lowest to highest.
  5. Confirm that the product grid reloads and the products are now ordered with the lowest-priced item first.
  6. Now select a sort option that orders products by price from highest to lowest.
  7. Confirm that the most expensive product now appears first.

Knowledge Check

Tips


FS-4: Reading Product Tiles

What It Is

A product tile is the individual card that represents a single product within a grid or carousel. Every product tile shows the same core information, making it easy to compare products at a glance. You will encounter product tiles on the Home screen (in the featured grid and carousel), the Search screen, and the Search Detail screen.

[Screenshot: A single product tile showing a product image, product title, price, and currency label]

What a Product Tile Shows

Element What It Tells You
Product image A photo of the product. If the product has multiple images, the tile typically shows the primary (featured) image.
Product title The name of the product.
Price The price of the product. If the product has multiple variants at different prices, this may show the starting price.
Currency The currency code (e.g., USD) displayed alongside the price.

Practice Exercise

  1. Navigate to the store's Home screen.
  2. Look at the featured product grid at the top of the page.
  3. For each of the three featured products, write down: (a) the product title, (b) the price, and (c) whether you can tell from the tile alone if the product has multiple variants.
  4. Now scroll down to the carousel and find the product with the lowest visible price.
  5. Click that product tile and confirm that the product detail page matches the title and price you saw on the tile.

Knowledge Check

Tips



Module 1: Orienting Yourself in the Store

Learning Objectives

After completing this module, you will be able to:

Estimated Time: 20–30 minutes


Lesson 1.1: Understanding the Home Screen Layout

What You'll Learn

The Home screen is the first thing visitors see when they arrive at the store. Understanding its layout helps you orient yourself quickly and know where to look for different types of content. In your daily work, this knowledge helps you guide customers or colleagues who are new to the store.

Before You Begin

No prerequisites — you can start this lesson at any time.

Walkthrough

  1. Open your web browser and navigate to the store's home page (the root URL provided by your system administrator).
  2. When the page loads, look at the top section of the page. You should see a prominent grid of three featured products — this is called the Featured Product Grid. It typically shows one large product on one side and two smaller products stacked on the other side.
  3. Scroll down past the featured grid. You will see a horizontally scrollable row of products — this is the Product Carousel. It displays a broader selection of products from the catalog.
  4. Continue scrolling to the very bottom of the page. You will reach the Footer, which contains navigation links to informational pages, legal information, and other site-wide resources.

[Screenshot: The full Home screen showing the three-item featured grid at the top, the product carousel in the middle, and the footer at the bottom]

You should now be able to identify all three sections of the Home screen.

Try It Yourself

  1. Navigate to the store's Home screen.
  2. Without clicking anything, identify and name all three sections of the page.
  3. In the Featured Product Grid, identify which product appears largest (this is the hero product).
  4. In the Product Carousel, count how many product tiles are visible without scrolling.
  5. Scroll to the Footer and identify at least two types of links it contains (for example: policy pages, about pages, or external links).
  6. Confirm that you can name all three sections and describe the purpose of each.

Knowledge Check

Tips & Gotchas


Lesson 1.2: Navigating from the Home Screen

What You'll Learn

The Home screen is a starting point, not a destination. Every product tile on the page is a doorway to a product detail page. In this lesson, you will practice navigating from the Home screen to product detail pages using both the featured grid and the carousel. This is the most common action a shopper takes on the Home screen.

Before You Begin

Complete Lesson 1.1: Understanding the Home Screen Layout first.

Also review FS-1: Working with Product Grids and FS-2: Working with Product Carousels if you have not already done so.

Walkthrough

Navigating from the Featured Product Grid:

  1. Navigate to the store's Home screen.
  2. Look at the Featured Product Grid at the top of the page.
  3. Identify the large hero product (the biggest tile in the grid).
  4. Click on the hero product tile.
  5. You will be taken to that product's Product Detail page. The URL in your browser's address bar will change to something like /product/product-name.
  6. Press your browser's Back button to return to the Home screen.

Navigating from the Carousel:

  1. Scroll down to the Product Carousel.
  2. Scroll the carousel to the right until you can see a product tile that was not visible when the carousel first loaded.
  3. Click on that product tile.
  4. You will be taken to that product's Product Detail page.
  5. Press your browser's Back button to return to the Home screen.

[Screenshot: The Home screen with an arrow indicating a product tile being clicked in the featured grid, and the resulting product detail page]

Try It Yourself

  1. Navigate to the store's Home screen.
  2. In the Featured Product Grid, click on one of the two smaller (secondary) product tiles — not the large hero product.
  3. Confirm that you arrive on a product detail page and that the product title matches what you saw on the tile.
  4. Return to the Home screen using your browser's Back button.
  5. Now scroll to the Product Carousel and click on the last product tile visible without scrolling (the rightmost one).
  6. Confirm that you arrive on a product detail page.
  7. Return to the Home screen.
  8. What-if variation: Scroll the carousel all the way to the right until no more new products appear. How many products are in the carousel in total?

Knowledge Check

Tips & Gotchas


What You'll Learn

The footer appears at the bottom of every page in the store. It contains links to important informational pages — such as the store's policies, about page, and legal information — that are not part of the product catalog. Knowing how to use the footer helps you quickly find information that is not a product.

Before You Begin

Complete Lesson 1.1: Understanding the Home Screen Layout first.

Walkthrough

  1. Navigate to the store's Home screen.
  2. Scroll to the very bottom of the page until the Footer is fully visible.
  3. Look at the links in the footer. These typically include pages such as About Us, Privacy Policy, Terms of Service, and similar informational content.
  4. Click on one of the footer links — for example, Privacy Policy.
  5. You will be taken to an informational page. The URL will change to something like /privacy-policy.
  6. The page will display a title, the full text of the policy, and a note showing when the page was last updated.
  7. To return to the Home screen, either press your browser's Back button or click the store's logo or home link in the site navigation.

[Screenshot: The footer section showing navigation links to informational pages]

Try It Yourself

  1. Navigate to the store's Home screen.
  2. Scroll to the Footer.
  3. Identify and click on the Terms of Service link (or a similar policy link if Terms of Service is not present).
  4. Confirm that you arrive on an informational page with a title, body content, and a "last updated" date.
  5. Return to the Home screen.
  6. What-if variation: Now try clicking a footer link that leads to an external resource (if any are present). Notice that external links may open in a new browser tab rather than navigating within the store.

Knowledge Check

Tips & Gotchas



Module 2: Discovering Products

Learning Objectives

After completing this module, you will be able to:

Estimated Time: 40–55 minutes


Lesson 2.1: Searching for Products by Keyword

What You'll Learn

The Search screen is the fastest way to find a specific product when you know what you are looking for. When you type a keyword and submit a search, the store filters its entire catalog and shows you only the matching products. This lesson teaches you how to perform a keyword search and read the results.

Before You Begin

Complete Module 1: Orienting Yourself in the Store first.

Review FS-1: Working with Product Grids and FS-4: Reading Product Tiles before continuing.

Walkthrough

  1. Locate the search bar in the site's navigation area (typically at the top of the page). Your trainer can point this out if you cannot find it.
  2. Click on the search bar to activate it.
  3. Type the word jacket into the search bar.
  4. Press Enter on your keyboard (or click the Search button if one is present).
  5. You will be taken to the Search screen at a URL like /search?q=jacket.
  6. At the top of the results area, look for a summary message. If results were found, you will see a message such as: "Showing 4 results for 'jacket'". If no results were found, you will see: "There are no products that match 'jacket'".
  7. Below the summary message (if results exist), you will see a product grid displaying the matching products.
  8. Each product tile in the grid shows the product image, title, price, and currency.

[Screenshot: The Search screen showing a results summary message and a grid of matching product tiles]

Try It Yourself

  1. Use the search bar to search for the word hoodie.
  2. Read the results summary message at the top of the page. Write down: (a) how many results were returned, and (b) the exact wording of the summary message.
  3. Identify the first product tile in the grid. Write down its title and price.
  4. Now clear the search bar and search for a word that is very unlikely to match any product — for example, xylophone.
  5. Confirm that the results summary message changes to indicate no matching products were found.
  6. Confirm that the product grid is no longer visible.

Knowledge Check

Tips & Gotchas


Lesson 2.2: Sorting Search Results

What You'll Learn

Once you have a set of search results, you can change the order in which products appear. Sorting is useful when you want to find the cheapest option, the newest arrivals, or the most popular products within your search results. This lesson teaches you how to apply and change sort options on the Search screen.

Before You Begin

Complete Lesson 2.1: Searching for Products by Keyword first.

Review FS-3: Understanding Sort Options before continuing.

Walkthrough

  1. Perform a search for the keyword shirt using the search bar. You should see a results grid with multiple products.
  2. Locate the sort control on the Search screen. This is typically a dropdown or a set of links near the top of the results area. Your trainer can point this out if you cannot find it.
  3. Note the current order of the products in the grid.
  4. Click the sort control and select the option for Price: Low to High (or the equivalent label in your store).
  5. The page will reload. The URL will update to include ?sort=price-asc (or a similar value). The product grid will now show the same products reordered from lowest to highest price.
  6. Verify that the first product in the grid has a lower price than the last product.
  7. Click the sort control again and select Price: High to Low.
  8. The page reloads. The product that was last is now first.

[Screenshot: The Search screen with the sort control highlighted and a grid showing products ordered by price]

Try It Yourself

  1. Search for the keyword pants.
  2. Apply the sort option for Newest Arrivals (or the equivalent label in your store).
  3. Note the title of the first product in the sorted grid.
  4. Now apply the sort option for Best Selling (or the equivalent label).
  5. Note whether the first product changed.
  6. What-if variation: Copy the URL from your browser's address bar while a sort is active. Open a new browser tab and paste the URL. Confirm that the same sort order is applied in the new tab.

Knowledge Check

Tips & Gotchas


Lesson 2.3: Browsing Products by Collection

What You'll Learn

A collection is a curated group of products organized by the store — for example, "T-Shirts", "New Arrivals", or "Sale Items". Browsing by collection is useful when you want to explore a category of products rather than search for something specific. The Search Detail screen displays all products in a given collection.

Before You Begin

Complete Lesson 2.1: Searching for Products by Keyword first.

Review FS-1: Working with Product Grids before continuing.

Walkthrough

  1. Locate the store's navigation menu (typically in the header or sidebar). Look for links to product categories or collections — for example, T-Shirts, Accessories, or New Arrivals.
  2. Click on a collection link — for example, New Arrivals.
  3. You will be taken to the Search Detail screen at a URL like /search/new-arrivals.
  4. The page displays a grid of all products in that collection.
  5. If the collection contains products, you will see the product grid. If the collection exists but contains no products, you will see the message: "No products found in this collection."
  6. Browse the grid by scrolling down. Click any product tile to view that product's detail page.
  7. Press your browser's Back button to return to the collection.

[Screenshot: The Search Detail screen showing a collection name and a grid of products belonging to that collection]

Try It Yourself

  1. Navigate to a collection called Accessories (or a different collection available in your store — ask your trainer for a valid collection name).
  2. Count the number of products visible in the grid without scrolling.
  3. Scroll down to see if there are more products below the fold.
  4. Identify the product with the highest price in the collection.
  5. Click on that product to confirm it takes you to the correct product detail page.
  6. Return to the collection page.
  7. What-if variation: Try navigating directly to a collection URL that does not exist — for example, type /search/this-collection-does-not-exist into your browser's address bar. What happens?

Knowledge Check

Tips & Gotchas


Lesson 2.4: Sorting a Collection

What You'll Learn

Just as you can sort search results, you can also sort the products within a collection. This lesson teaches you how to apply sort options on the Search Detail (collection) screen. The sort behavior is identical to what you learned for search results, but it applies to a collection rather than a keyword search.

Before You Begin

Complete Lesson 2.3: Browsing Products by Collection first.

Review FS-3: Understanding Sort Options before continuing.

Walkthrough

  1. Navigate to a collection page — for example, /search/t-shirts.
  2. Observe the default order of products in the grid.
  3. Locate the sort control on the page.
  4. Select the sort option for Price: Low to High.
  5. The page reloads. The URL updates to include ?sort=price-asc. The products are now ordered from lowest to highest price.
  6. Select the sort option for Newest Arrivals (or equivalent).
  7. The page reloads again with the new sort applied.
  8. Notice that the collection handle in the URL (/search/t-shirts) remains unchanged — only the ?sort= parameter changes.

Try It Yourself

  1. Navigate to a collection of your choice.
  2. Apply the Best Selling sort option.
  3. Write down the title of the first three products in the sorted grid.
  4. Now apply the Price: High to Low sort option.
  5. Write down the title of the first three products in the new order.
  6. Compare the two lists. Did the order change?
  7. What-if variation: Remove the ?sort= parameter from the URL manually (by editing the address bar and pressing Enter). What sort order is applied?

Knowledge Check

Tips & Gotchas


Lesson 2.5: Interpreting Search and Collection Results

What You'll Learn

Knowing how to read the results page — not just how to interact with it — is an important skill. This lesson focuses on interpreting what the Search and Search Detail screens are telling you, including result counts, empty states, and what the absence of a summary message means.

Before You Begin

Complete Lesson 2.1: Searching for Products by Keyword and Lesson 2.3: Browsing Products by Collection first.

Walkthrough

Reading the results summary (Search screen only):

  1. Navigate to the Search screen and search for the keyword bag.
  2. Read the results summary at the top of the results area. It will say one of:
  3. Note that the summary uses the correct singular or plural form ("result" vs. "results") automatically.

Understanding the absence of a summary (browsing without a keyword):

  1. Navigate to the Search screen without entering a keyword (go directly to /search).
  2. Notice that there is no results summary message at the top of the page. This is intentional — when you are browsing all products without a search term, the store does not display a count.
  3. The product grid still appears and shows all available products.

Reading the collection empty state:

  1. If your trainer can provide a collection that is currently empty, navigate to it.
  2. You will see the message: "No products found in this collection." This means the collection exists but has no products assigned to it.

[Screenshot: Side-by-side comparison of the Search screen with results (showing summary message) and without results (showing no-results message)]

Try It Yourself

  1. Navigate to the Search screen and search for the keyword glove.
  2. Read and record the exact results summary message.
  3. Now navigate to the Search screen without a keyword.
  4. Confirm that no summary message appears, even though products are visible in the grid.
  5. Navigate to a collection page.
  6. Confirm that the collection page also shows no results summary message (collections never show a count summary).
  7. Analysis task: Based on what you have observed, write a one-sentence explanation of when the results summary message appears and when it does not.

Knowledge Check

Tips & Gotchas



Module 3: Evaluating a Product

Learning Objectives

After completing this module, you will be able to:

Estimated Time: 35–50 minutes


Lesson 3.1: Reading a Product Detail Page

What You'll Learn

The Product Detail page is where shoppers make their purchase decisions. It contains everything you need to know about a product: images, title, description, price, and availability. Understanding the layout of this page helps you find information quickly and helps you guide others who are evaluating a product.

Before You Begin

Complete Module 2: Discovering Products first, so you know how to navigate to a product detail page.

Walkthrough

  1. Navigate to any product detail page (by clicking a product tile from the Home screen, Search screen, or a collection page).
  2. Observe the overall layout. The page is divided into two main areas side by side (on a large screen) or stacked vertically (on a small screen):
  3. In the Product Description Panel, locate and read:
  4. Scroll down below the main product card. If the store has recommendations for this product, you will see a Related Products section with a heading and a row of product tiles.
  5. Scroll to the very bottom of the page to find the Footer.

[Screenshot: A product detail page showing the image gallery on the left, the product description panel on the right, and the related products section below]

Try It Yourself

  1. Navigate to a product detail page for a product that has at least two images (you can find one by browsing the catalog).
  2. Identify and write down: (a) the product title, (b) the price, (c) whether variant options are available, and (d) whether a Related Products section is visible.
  3. Now navigate to a different product — one that you found via a search for the keyword accessory (or a similar term available in your store).
  4. Compare the two product pages. Do both have a Related Products section? Do both have variant selectors?
  5. Confirm that both pages follow the same two-column layout (gallery on the left, description on the right).

Knowledge Check

Tips & Gotchas


Lesson 3.2: Browsing Product Images

What You'll Learn

Most products have multiple photos showing different angles, details, or color options. The Product Image Gallery lets you browse through these images without leaving the product page. This lesson teaches you how to navigate the gallery so you can fully evaluate a product before making a decision.

Before You Begin

Complete Lesson 3.1: Reading a Product Detail Page first.

Walkthrough

  1. Navigate to a product detail page for a product that has multiple images. (If you are unsure which products have multiple images, browse the catalog and look for products with thumbnail strips or navigation arrows in the gallery area.)
  2. Look at the Product Image Gallery on the left side of the page (or top on mobile).
  3. The gallery displays the main (primary) image prominently.
  4. If the product has additional images, you will see thumbnail images below or beside the main image. Click on a thumbnail to display that image as the main image.
  5. Alternatively, use the Previous and Next navigation arrows (if present) to cycle through images one at a time.
  6. Notice that the gallery displays a maximum of 5 images per product, even if the product has more photos in the store's catalog.

[Screenshot: The product image gallery showing a large main image with thumbnail images below it]

Try It Yourself

  1. Navigate to a product detail page for a product with at least three images.
  2. Click on the second thumbnail image. Confirm that the main image updates to show the second photo.
  3. Click on the third thumbnail image. Confirm that the main image updates again.
  4. Use the navigation arrows (if available) to cycle back to the first image.
  5. What-if variation: Navigate to a product that has only one image. Confirm that no thumbnail strip or navigation arrows are visible (since there is nothing to navigate to).

Knowledge Check

Tips & Gotchas


Lesson 3.3: Selecting Product Variants

What You'll Learn

Many products come in multiple options — for example, a shirt might be available in sizes Small, Medium, and Large, or in colors Red, Blue, and Green. These options are called variants. Before you can add a product to your cart, you typically need to select the specific variant you want. This lesson teaches you how to identify and select variants on the Product Detail page.

Before You Begin

Complete Lesson 3.1: Reading a Product Detail Page first.

Walkthrough

  1. Navigate to a product detail page for a product that has variants (for example, a clothing item with size options).
  2. In the Product Description Panel on the right side of the page, look for the variant selector controls. These may appear as:
  3. Read the label above the selector to understand what type of option you are choosing (e.g., Size, Color, Material).
  4. Click on the variant option you want — for example, click Medium.
  5. The selected option will be visually highlighted (e.g., with a border, background color, or checkmark).
  6. If the product has more than one type of variant (e.g., both size and color), repeat the selection for each variant type.
  7. Notice that the price displayed in the panel may update if different variants have different prices.

[Screenshot: The Product Description Panel showing variant selector buttons with one option selected and highlighted]

Try It Yourself

  1. Navigate to a product detail page for a clothing item with size variants.
  2. Select the size Large (or the largest available size if Large is not present).
  3. Confirm that the Large option is visually highlighted.
  4. Now select a different size — for example, Small.
  5. Confirm that Small is now highlighted and Large is no longer highlighted.
  6. If the product also has a color variant, select a color of your choice.
  7. What-if variation: Navigate to a product that has no variants. Confirm that no variant selector controls are visible in the Product Description Panel.

Knowledge Check

Tips & Gotchas


Lesson 3.4: Adding a Product to Your Cart

What You'll Learn

Once you have evaluated a product and selected your preferred variants, the next step is to add it to your cart. The Add to Cart button is located in the Product Description Panel on the Product Detail page. This lesson teaches you how to complete this action.

Before You Begin

Complete Lesson 3.3: Selecting Product Variants first.

Walkthrough

  1. Navigate to a product detail page.
  2. In the Product Description Panel, select any required variants (size, color, etc.) as described in Lesson 3.3: Selecting Product Variants.
  3. Locate the Add to Cart button in the Product Description Panel.
  4. Click the Add to Cart button.
  5. The application will process your request. You should see a visual confirmation that the item has been added — this may be a change in the button's appearance, a notification message, or an update to a cart icon in the navigation bar.

Note: The cart, checkout, and order management workflows continue on additional screens not included in this document. Please consult your system administrator for the complete purchasing process.

[Screenshot: The Product Description Panel with the Add to Cart button highlighted]

Try It Yourself

  1. Navigate to a product detail page for a product with at least one variant.
  2. Select the variant option for Medium (or the middle-sized option available).
  3. Click the Add to Cart button.
  4. Observe and record what visual feedback you receive confirming the item was added.
  5. What-if variation: Navigate to a product that is listed as out of stock (if one is available in your store). Observe whether the Add to Cart button is available or disabled. What does the page show instead?

Knowledge Check

Tips & Gotchas


What You'll Learn

At the bottom of many product detail pages, you will find a Related Products section. This section shows products that the store's system has identified as similar or complementary to the one you are viewing. Using this section is a great way to discover products you might not have found through search or browsing.

Before You Begin

Complete Lesson 3.1: Reading a Product Detail Page first.

Review FS-4: Reading Product Tiles before continuing.

Walkthrough

  1. Navigate to a product detail page.
  2. Scroll down below the main product card (the area containing the gallery and description panel).
  3. Look for a section with the heading "Related Products".
  4. If the section is present, you will see a horizontally scrollable row of product tiles. Each tile shows the product image, title, price, and currency.
  5. Scroll the related products row left or right to see all available recommendations.
  6. Click on any related product tile to navigate to that product's detail page.
  7. You will be taken to the new product's detail page. Notice that the URL changes to reflect the new product's handle.
  8. The new product page may also have its own Related Products section, allowing you to continue exploring.

[Screenshot: The Related Products section at the bottom of a product detail page, showing a horizontal row of product tiles]

Try It Yourself

  1. Navigate to a product detail page for a clothing item.
  2. Scroll to the Related Products section.
  3. Identify the related product with the highest price.
  4. Click on that product tile to navigate to its detail page.
  5. On the new product page, scroll to its Related Products section (if present).
  6. Check whether the original product you started from appears as a related product on this new page.
  7. What-if variation: Navigate to a product that has no Related Products section. Confirm that the section is simply absent — there is no empty placeholder or "no recommendations" message.

Knowledge Check

Tips & Gotchas



Module 4: Reading Informational Pages

Learning Objectives

After completing this module, you will be able to:

Estimated Time: 20–25 minutes


Lesson 4.1: Navigating to an Informational Page

What You'll Learn

Informational pages — such as the store's Privacy Policy, Terms of Service, About Us, and FAQ — are managed by the store's administrator and are accessible through the site's navigation (typically the footer or header menu). This lesson teaches you how to find and navigate to these pages.

Before You Begin

Complete Lesson 1.3: Using the Footer for Site Navigation first.

Walkthrough

  1. From any page in the store, scroll to the Footer at the bottom of the page.
  2. Look for links to informational pages. Common examples include:
  3. Click on the Privacy Policy link.
  4. You will be taken to the informational page at a URL like /privacy-policy.
  5. The page loads and displays its content.
  6. To navigate to a different informational page, scroll back to the footer and click a different link — or use your browser's Back button to return to where you came from.

Navigating directly by URL:

  1. If you know the URL of an informational page, you can navigate to it directly by typing the URL into your browser's address bar. For example, typing /about will take you to the About Us page (if it exists).

[Screenshot: The footer with informational page links highlighted, and the resulting informational page]

Try It Yourself

  1. From the Home screen, navigate to the Terms of Service page using the footer.
  2. Confirm that the page loads and displays content.
  3. Note the URL in your browser's address bar.
  4. Now try navigating directly to the About Us page by typing /about into your browser's address bar (replace the domain with your store's domain).
  5. Confirm that the page loads.
  6. What-if variation: Try navigating to a page that does not exist — for example, type /this-page-does-not-exist into the address bar. What happens?

Knowledge Check

Tips & Gotchas


Lesson 4.2: Reading and Interpreting Page Content

What You'll Learn

Every informational page in the store follows the same consistent structure: a title, the main content, and a "last updated" date. Knowing this structure helps you quickly find the information you need and verify that you are reading the most current version of a policy or document.

Before You Begin

Complete Lesson 4.1: Navigating to an Informational Page first.

Walkthrough

  1. Navigate to any informational page — for example, the Privacy Policy.
  2. At the very top of the page content, you will see the page title displayed as a large heading (for example, "Privacy Policy"). This confirms which page you are on.
  3. Below the title, you will see the main content of the page. This is the full text of the document, which may include headings, paragraphs, bullet lists, and links — all formatted for easy reading.
  4. Scroll through the content to read it. The content may be long — use your browser's scroll bar or keyboard arrow keys to move through it.
  5. At the bottom of the page content (before the footer), look for a small line of italic text that reads something like: "This document was last updated on January 15, 2024." This is the last updated date, and it tells you when the content was most recently changed.
  6. Note the format of the date: it is written out in full (month name, day, and year) for clarity.

[Screenshot: An informational page showing the title heading at the top, formatted body content in the middle, and the last updated date in small italic text at the bottom]

Try It Yourself

  1. Navigate to the About Us page (or a similar informational page available in your store).
  2. Identify and write down: (a) the page title, (b) the approximate length of the content (short, medium, or long), and (c) the last updated date.
  3. Now navigate to the FAQ page (or another informational page).
  4. Identify the same three elements: title, content, and last updated date.
  5. Compare the last updated dates of the two pages. Which one was updated more recently?
  6. What-if variation: Look for any hyperlinks within the body content of an informational page. Click one. Where does it take you? Does it open in the same tab or a new tab?

Knowledge Check

Tips & Gotchas



Capstone Exercise

Your Mission

You are helping a new customer who has contacted the store with the following request:

"I'm looking for a medium-sized blue hoodie under $80. I also want to check the store's return policy before I buy anything. And if the hoodie I find has any similar products, I'd like to see those too."

Your task is to complete this entire workflow from start to finish — without step-by-step instructions. Use the skills you have learned throughout this manual.

What You Need to Do

  1. Find the product. Use the store's search functionality to find hoodies. Sort the results to help you identify options under $80. Navigate to a product detail page for a hoodie that meets the customer's criteria.

  2. Evaluate the product. On the product detail page, browse the product images to get a full view of the item. Select the Medium size variant and the blue color variant (if available). Confirm the price is within the customer's budget.

  3. Check the return policy. Without losing your place on the product page, navigate to the store's return or refund policy page (check the footer for a link). Read the page and note the last updated date. Return to the product page.

  4. Explore related products. Scroll to the Related Products section on the hoodie's product detail page. Identify at least one related product that might also interest the customer. Navigate to that related product's page and note its title and price.

  5. Report back. At the end of the exercise, you should be able to answer:

Success Criteria

You have successfully completed the Capstone Exercise when:

Modules Covered

This exercise combines skills from:



Glossary

Term Definition
Available for Sale A product status indicating that at least one variant of the product is currently in stock and can be purchased. Products that are not available for sale may still be visible on the storefront but cannot be added to the cart.
Carousel A horizontally scrollable row of product tiles used to display a selection of products. Users scroll left or right to browse. Found on the Home screen below the Featured Product Grid.
Collection A curated grouping of products in the store, organized by the store's administrator. Examples include "T-Shirts", "New Arrivals", and "Sale Items". Collections are browsed via the Search Detail screen at URLs like /search/[collection-name].
Collection Handle The URL-safe identifier for a collection, derived from its title (e.g., "New Arrivals" becomes new-arrivals). Used as the dynamic segment in the Search Detail screen URL.
Default Sort The sort order applied to a product grid when no sort option has been explicitly selected. Typically relevance or best-selling order.
Featured Product Grid The prominent grid of three highlighted products at the top of the Home screen. Typically shows one large hero product and two smaller secondary products. Also referred to as the Three-Item Grid.
Footer The section at the very bottom of every page in the store. Contains navigation links to informational pages (such as policies and about pages), legal information, and other site-wide resources.
Handle Shopify's URL-safe string identifier for a resource such as a product or collection. Derived from the resource's title (e.g., "Classic White Tee" becomes classic-white-tee). Used in page URLs.
Hero Product The largest, most prominently displayed product in the Featured Product Grid on the Home screen. Receives the highest visual priority on the page.
Informational Page A content page in the store used for static text such as policies, FAQs, and about pages. Managed by the store's administrator in Shopify. Accessible via footer links or direct URL. Examples: Privacy Policy, Terms of Service, About Us.
JSON-LD A structured data format embedded in product pages that helps search engines understand the page content and generate rich search results. Not visible to users but affects how the page appears in search engine listings.
Last Updated Date The date displayed at the bottom of every informational page, indicating when the page content was most recently modified. Formatted as a full date (e.g., "January 15, 2024").
Page Handle The URL-safe identifier for an informational page in Shopify (e.g., privacy-policy, about). Used as the dynamic segment in the informational page URL (/[page]).
Page Not Found (404) An error response shown when you navigate to a URL that does not correspond to any existing page, product, or collection in the store.
Price Range The spread of prices across all variants of a product. A product with sizes Small ($20) and Large ($25) has a price range of $20–$25. Displayed on the product detail page.
Product Carousel See Carousel.
Product Detail Page The page that displays full information about a single product, including images, title, description, price, variant options, and add-to-cart functionality. Accessible at URLs like /product/[product-handle].
Product Grid A responsive layout that displays multiple product tiles in rows and columns. Adjusts from 1 column (mobile) to 2 columns (tablet) to 3 columns (desktop). Found on the Search screen and Search Detail screen.
Product Image Gallery The image viewer on the left side of the Product Detail page. Displays up to 5 product images with thumbnail navigation.
Product Tile An individual card within a product grid or carousel representing a single product. Displays the product image, title, price, and currency. Clicking a tile navigates to the product's detail page.
Related Products A section at the bottom of the Product Detail page showing algorithmically recommended products similar to the one being viewed. Generated automatically by the store's recommendation system. Not present on every product page.
Results Summary The text message at the top of the Search screen that tells you how many products matched your search query (e.g., "Showing 3 results for 'jacket'") or that no products matched. Only appears when a search keyword has been entered.
SEO Search Engine Optimization — practices that help the store's pages appear in search engine results. Relevant to users because it affects how pages are described when shared on social media or found via Google.
Shopify The e-commerce platform that powers this store's product catalog, collections, informational pages, and checkout. The store's administrator manages products and content through Shopify's admin interface.
Sort Option A user-selectable ordering for a product grid. Common options include Price: Low to High, Price: High to Low, Newest Arrivals, and Best Selling. Applied via a sort control on the Search and Search Detail screens.
Sort Slug The URL-safe identifier for a sort option (e.g., price-asc, trending). Appears in the URL as a ?sort= query parameter when a sort option is active.
Storefront The public-facing website of the store — the screens covered in this manual. Distinct from the Shopify admin interface used by store administrators.
Variant A specific version of a product defined by one or more options such as size, color, or material. For example, a shirt in size Medium and color Blue is one variant. Variants may have different prices and stock levels.
Variant Selector The interactive control on the Product Detail page that allows you to choose a specific variant of a product (e.g., a set of size buttons or a color swatch grid).


Skills Checklist

Use this checklist to track your progress through the training. After completing each lesson, return here and check off the skills you have practiced.

Foundation Skills

Module 1: Orienting Yourself in the Store

Module 2: Discovering Products

Module 3: Evaluating a Product

Module 4: Reading Informational Pages

Capstone Exercise



Appendix A: Source Traceability

This appendix is for the document maintainer. It maps each module and lesson to the application screen(s) from which the content was derived.

Module / Lesson Source Screen(s) Route(s)
FS-1: Working with Product Grids Search, Search Detail /search, /search/[collection]
FS-2: Working with Product Carousels Home /
FS-3: Understanding Sort Options Search, Search Detail /search, /search/[collection]
FS-4: Reading Product Tiles Home, Search, Search Detail, Product Detail /, /search, /search/[collection], /product/[handle]
Lesson 1.1: Understanding the Home Screen Layout Home /
Lesson 1.2: Navigating from the Home Screen Home, Product Detail /, /product/[handle]
Lesson 1.3: Using the Footer for Site Navigation Home, Item Detail /, /[page]
Lesson 2.1: Searching for Products by Keyword Search /search
Lesson 2.2: Sorting Search Results Search /search
Lesson 2.3: Browsing Products by Collection Search Detail /search/[collection]
Lesson 2.4: Sorting a Collection Search Detail /search/[collection]
Lesson 2.5: Interpreting Search and Collection Results Search, Search Detail /search, /search/[collection]
Lesson 3.1: Reading a Product Detail Page Product Detail /product/[handle]
Lesson 3.2: Browsing Product Images Product Detail /product/[handle]
Lesson 3.3: Selecting Product Variants Product Detail /product/[handle]
Lesson 3.4: Adding a Product to Your Cart Product Detail /product/[handle]
Lesson 3.5: Exploring Related Products Product Detail /product/[handle]
Lesson 4.1: Navigating to an Informational Page Item Detail, Home /[page], /
Lesson 4.2: Reading and Interpreting Page Content Item Detail /[page]
Capstone Exercise Home, Search, Search Detail, Product Detail, Item Detail /, /search, /search/[collection], /product/[handle], /[page]


Appendix B: Documentation Coverage

This appendix is for the document maintainer. It identifies gaps, inferences, and verification requirements before this document is distributed to end users.

Screens Covered

Screen Route Coverage Status
Home / Covered — layout and navigation documented
Item Detail /[page] Covered — content display and structure documented
Product Detail /product/[handle] Covered — layout documented; child component interactions partially documented
Search /search Covered — query and sort parameters documented
Search Detail /search/[collection] Covered — collection browsing and sort documented

Screens Not Covered

The following functional areas are known to exist based on references within the assessed screens but were not part of this assessment:

Area Evidence of Existence Impact on This Document
Shopping Cart Referenced in Product Detail documentation (add-to-cart action) Lesson 3.4 cannot describe post-add-to-cart behavior
Checkout Standard e-commerce workflow implied by cart existence Not covered; noted in Lesson 3.4
Account / Login Not referenced in assessed screens Not covered
Site Header / Navigation Bar Referenced as the location of the search bar and navigation links Sort controls and search input location cannot be fully verified
404 Not Found page Referenced in multiple screens via notFound() behavior Described by outcome only; visual appearance not documented
Error page Referenced in multiple screens via error boundary behavior Described by outcome only; visual appearance not documented

Partially Documented Workflows

Workflow Documented Steps Gap
Adding to Cart Step 1 (navigate to product), Step 2 (select variant), Step 3 (click Add to Cart) Steps 4 onward (cart confirmation, cart management, checkout) could not be verified from available documentation. WHO: Development team lead. WHAT: What visual feedback does the user receive immediately after clicking Add to Cart? Does a cart drawer open, a toast notification appear, or does the cart icon update? WHERE: Insert answer into Lesson 3.4: Adding a Product to Your Cart, Step 5 and the Try It Yourself exercise.
Search Input Submission Results display is documented The search bar component itself (location, label, submit mechanism) is not documented — it is described as being in the site header, which was not assessed. WHO: Development team lead or product owner. WHAT: Where exactly is the search bar located? What is its label or placeholder text? Is there a submit button, or does the user press Enter? WHERE: Insert answer into Lesson 2.1: Searching for Products by Keyword, Steps 1–4, and FS-3: Understanding Sort Options.
Sort Control Interaction Sort behavior (URL parameter, result reordering) is documented The sort control UI component itself (dropdown vs. links, label, location on page) is not documented — it is described as being in a layout component not assessed. WHO: Development team lead or product owner. WHAT: What does the sort control look like? Is it a dropdown, a set of buttons, or links? Where on the Search and Search Detail pages is it positioned? What are the exact labels for each sort option? WHERE: Insert answer into FS-3: Understanding Sort Options, Lesson 2.2: Sorting Search Results Steps 2–4, and Lesson 2.4: Sorting a Collection Steps 3–4.
Collection Navigation Collection page display is documented How users navigate to a collection (the navigation menu or links that point to /search/[collection]) is not documented. WHO: Product owner. WHAT: Where in the site navigation do collection links appear? Are they in a header menu, sidebar, or elsewhere? WHERE: Insert answer into Lesson 2.3: Browsing Products by Collection, Steps 1–2.

Information Inferred from Technology Conventions

The following items were described in this manual based on standard e-commerce and web application conventions rather than explicit documentation. These should be verified before distribution.

Item Where Inferred Recommendation
Carousel navigation arrows (Previous/Next buttons) The documentation states the carousel "may also include previous/next navigation controls" — this is conditional, not confirmed. WHO: Development team lead. WHAT: Does the Carousel component include Previous/Next arrow buttons? If so, what are they labeled? WHERE: Update FS-2: Working with Product Carousels and Lesson 1.2: Navigating from the Home Screen.
Variant selector visual appearance (buttons vs. dropdown vs. swatches) The documentation confirms variant selectors exist within ProductDescription but does not describe their visual form. WHO: Development team lead. WHAT: What do the variant selector controls look like? Are they buttons, a dropdown, color swatches, or a combination? WHERE: Update Lesson 3.3: Selecting Product Variants, Steps 2–5 and the screenshot placeholder.
Add to Cart button label The documentation confirms an add-to-cart action exists within ProductDescription but does not state the exact button label. WHO: Development team lead. WHAT: What is the exact label on the add-to-cart button? WHERE: Update Lesson 3.4: Adding a Product to Your Cart, Step 3.
Out-of-stock variant visual treatment The documentation confirms availableForSale exists as a field but does not describe how unavailable variants are displayed to users. WHO: Development team lead. WHAT: How are out-of-stock variants displayed? Are they greyed out, hidden, or shown with a strikethrough? WHERE: Update Lesson 3.3: Selecting Product Variants, Tips & Gotchas.
Footer link labels and grouping The documentation confirms the Footer component exists and contains navigation links but does not enumerate the specific links or their labels. WHO: Product owner or store administrator. WHAT: What links appear in the footer? What are their exact labels? WHERE: Update Lesson 1.3: Using the Footer for Site Navigation and Lesson 4.1: Navigating to an Informational Page.
Available sort option labels The documentation confirms sort options exist and are defined in lib/constants but does not enumerate the specific options or their user-facing labels. WHO: Development team lead. WHAT: What are the exact user-facing labels for each sort option (e.g., "Price: Low to High", "Newest Arrivals", "Best Selling")? WHERE: Update FS-3: Understanding Sort Options, Lesson 2.2, and Lesson 2.4.
Gallery thumbnail navigation behavior The documentation confirms the Gallery component exists and displays up to 5 images but does not describe the exact thumbnail interaction model. WHO: Development team lead. WHAT: Does the Gallery use clickable thumbnails, arrow navigation, or both? Is there a zoom or full-screen mode? WHERE: Update Lesson 3.2: Browsing Product Images.

Overall Recommendation

Before distributing this manual to end users, the document maintainer should:

  1. Verify all inferred UI details listed above with the development team lead, particularly the sort control appearance, variant selector appearance, and Add to Cart button label — these appear in multiple lessons and exercises.
  2. Assess the site header/navigation component to document the search bar and collection navigation links, which are referenced throughout Modules 2 and 3 but were not part of this assessment.
  3. Assess the cart and checkout screens to complete the add-to-cart workflow in Lesson 3.4 and enable a more complete Capstone Exercise.
  4. Replace all [Screenshot: ...] placeholders with actual screenshots from the live application.
  5. Conduct a walkthrough review with a subject matter expert (product owner or experienced store user) to verify that all described workflows match actual application behavior.