Pepperell Crafts

Your store, in your hands.

A plain-language guide to running the Pepperell Crafts theme yourself: adding products, editing the homepage, curating collections, and going live. No code, no developer needed.

Everything below is done from your Shopify admin. Nothing here can break the store as long as you preview before you publish.

01 · Getting around

How the theme editor works

Almost everything visual is edited in one place: the theme editor. Learn these few ideas once and the rest of the guide is easy.

  1. From your Shopify admin, open Online Store, then Themes.
  2. Find your theme in the list and click Customize. This opens the theme editor.
  3. The left panel is your controls. The large area on the right is a live preview of your store.
The theme editor with the section list on the left and a live preview of the homepage on the right
The theme editor: section list on the left, live preview on the right.

Sections, blocks, and settings

Your pages are built from sections stacked top to bottom (the hero, the category grid, best sellers, and so on). Click a section in the left panel to open its settings. Some sections also contain blocks, which are the repeatable items inside them, like each message in the top bar or each column in the trust strip.

Read the grey helper text

Under most fields you will see a short grey line that explains what the field does and where it shows up on the store. We wrote these for you. When in doubt, read the helper text first.

Save, preview, publish

Changes you make are saved to the theme you are editing, but they do not go live until you publish that theme. So you can edit freely, look at the preview, and only publish when it looks right. Publishing is covered in the last chapter.

02 · Products

Adding a product and its craft fields

A product needs the usual basics, plus a few Pepperell fields that power your category pages, filters, and the specifications table.

The basics

  1. In the admin, open Products, then click Add product.
  2. Fill in the Title and Description. Write the description the way a customer would want to read it.
  3. Under Media, upload clear photos. The first photo is the one shown on cards and at the top of the product page.
  4. Set the Price, and if the item comes in colors or sizes, add them under Variants.
  5. On the right, set Status to Active and make sure the Online Store sales channel is ticked so the product is visible.
The Products list in the Shopify admin
Products list. Add product is at the top right.

The Pepperell craft fields

Scroll down the product page to the Product metafields card. These five fields are what make your store's category pages and filters work. Fill them in for every product.

The Product metafields card showing Main category, Audience, Skill level, Material, and Project
The craft fields live in the Product metafields card, part way down the product page.
FieldWhat it doesHow to fill it
Main categoryDecides which of your eight category pages the product appears on. This is the most important field.Type one of the eight values below, exactly.
MaterialShows in the specifications table and powers the material filter.Pick one or more from the dropdown.
Skill levelUsed on kits to show and filter by difficulty.Pick Beginner, Intermediate, or Advanced. Leave blank for non-kit items.
AudienceOptional grouping, for example Kids or Adults.Pick from the dropdown if it applies, otherwise leave blank.
ProjectWhat the product is used to make, for filtering and discovery.Pick one or more from the dropdown.

Four of these five fields are dropdowns, so you choose from a set list and never worry about spelling. Main category is the exception: it is a typed field, because it also builds your category pages automatically, and Shopify does not let a field do both.

Main category must match exactly

Type the category exactly as one of these, including the punctuation, or the product will not appear on its category page:

  • Cords & Lacing
  • Kits, Books & Patterns
  • Beads, Findings & Closures
  • Wood, Slates & Naturals
  • Tools & Workshop
  • Decor, Toys & Finished Pieces
  • Oil Lamp & Specialty Candle Supplies
  • Industrial Products

Product type: the subcategory

Separate from Main category, each product also has a Type, set in the Product organization card on the right of the product page. Type is the narrower subcategory, for example Paracord, Macramé Cord, Kits, or Fiberglass Wick. It powers the "Product type" filter that shoppers use to narrow down a category page.

When you start typing in the Type field, Shopify suggests the types you have used before. Pick an existing one where it fits, rather than inventing a new spelling for something that already exists, so the filter stays tidy.

The fastest way to stay consistent

Open a similar product that is already set up, copy how its fields are filled in, and match that. It is the quickest way to get Main category and Type right.

Adding a new option to a dropdown

The dropdowns for Material, Project, Skill level, and Audience are typo-proof, and you can grow them yourself whenever a new one comes up. Open Settings, then Custom data, then Products, and click the field you want, for example Skill level. Under Validation you will see the list of choices; use Add item to add a new one and save. From then on it appears in the dropdown on every product.

The Skill level field set to a Choice list, showing its choices Advanced, Beginner, and Intermediate with an Add item button
A dropdown field is a "Choice list". Its choices are listed under Validation, and Add item adds a new one.

03 · Homepage

Editing the homepage sections

Open the theme editor on the homepage and click any section to change its words, images, and buttons. Here is what each homepage section is for.

SectionWhat you control
Announcement barThe messages in the thin bar at the very top. Type [[amount]] in a message and it fills in your free-shipping amount automatically.
Marquee + Bento heroThe big opening headline, its buttons, the moving wall of products behind it, and the four small stats.
Shop by categoryThe grid of your eight category cards.
Featured collectionA row of products, used for Best sellers and for Kits.
Heritage blockYour story section with a photo and text.
Trust stripThe row of reassurances, for example returns and secure checkout.
TestimonialsThe customer reviews heading and intro.
Featured blogThe latest posts from your blog.
TikTok feedYour short videos. See chapter 06.

Every field has helper text under it explaining exactly what it changes. For example, the hero's headline is split into three parts so one word can appear in the handwritten accent font.

The hero section settings open in the editor with helper text under each field
A section's settings, with plain-language helper text under each field.

Choosing the products in the hero

The moving product wall in the hero is yours to set. Open the hero section and either pick a Collection to pull from, or use the Product handles field to hand-pick exact products by handle, separated by commas. Leaving the handles blank falls back to the collection. The alternate wall-style hero has three rows, each with its own collection and product-handles field, so you can feature a different set in each row.

Turning decorations on or off

Many sections have two tick boxes near the bottom: one hides the small dotted beads on the wavy edge above the section, the other hides the faint background doodle. Use them if a section feels too busy.

04 · Product rows

Best sellers and product rows

The Best sellers and Kits rows on the homepage are both the Featured collection section. You choose which products show, in what order.

  1. In the editor, click the Featured collection section you want to change (Best sellers or Kits).
  2. To show a whole collection, pick it under Collection.
  3. To hand-pick exact products, use Product handles: type each product's handle, separated by commas, in the order you want them.
  4. Set How many products to display, and choose the small Badge shown on each card (brand, skill level, or none).
Where a product's handle comes from

A handle is the end of a product's web address. If the product page is /products/6mm-bonnie-braid-100-yards, the handle is 6mm-bonnie-braid-100-yards. To show a specific photo, add a colon and the photo number, for example 6mm-bonnie-braid-100-yards:3.

05 · Collections

Collections and the eight categories

Your eight category pages fill themselves automatically. A product joins a category the moment you set its Main category field.

You do not add products to a category by hand. Each category is a smart collection that gathers every product whose Main category matches. So the way to move a product between categories is to change that one field on the product (chapter 02).

Editing a category's look

  1. In the admin, open Products, then Collections.
  2. Click the category you want to change. Here you can edit its title, description, and the image used on the homepage card.
  3. Leave the Conditions alone. They are what keep the category filled automatically.
Do not delete the eight category collections

They are wired into the navigation and the homepage. You can rename them and change their images, but deleting one will leave gaps on the site.

06 · Social

TikTok and Instagram

The homepage can show your latest short videos and posts. Both sections have a simple on and off switch.

TikTok

  1. In the editor, click the TikTok feed section.
  2. Enter your TikTok username without the @ sign, and the full link to your profile.
  3. Use Show section to turn the whole thing on or off.

You add each video yourself. Add a block for each one and paste that video's share link. TikTok has no automatic "latest from my account" feed, so the videos shown are exactly the ones you add here, in the order you add them. Leave the Feed source setting as it is.

Instagram

The Instagram section works the same way: your username, your profile link, a show or hide switch, and a block for each post. If a live feed cannot load, the section shows a friendly button to your profile instead. Instagram also has an optional way to pull your latest posts in automatically through a service called Behold, but that is a one-time advanced setup, so leave the Feed source and Behold fields as they are unless it has been set up for you.

07 · Brand

Colors, fonts, and store details

Store-wide choices live in one place. In the theme editor, click the gear icon for Theme settings.

The Theme settings panel showing the brand color controls
Theme settings hold the store-wide brand controls.
GroupWhat's inside
ColorsYour brand orange, cream, and text colors. The main orange drives buttons, the top bar, and links across the whole store.
TypographyThe heading and body fonts, and a slider to make all text a little larger or smaller.
CartWhether adding to cart opens a drawer or a full page, and your free-shipping amount. Change it in one place here and it updates everywhere, including the top bar.
Social linksYour Instagram, Facebook, YouTube, Pinterest, and TikTok links. A blank field hides that icon.
Store detailsYour public phone number, email, and short location line, shown in the footer and contact areas.
Product displayOptional switches for badges, gift wrapping, delivery estimates, and which specification rows to show.
One number, everywhere

The free-shipping amount is a good example of how the theme avoids surprises. You set it once under Cart, and the top bar, the cart progress bar, and the product page all read from it.

08 · Reviews

Customer reviews (Judge.me)

Reviews are handled by the Judge.me app. They appear on each product page and as star ratings on product cards.

Where reviews show

The full reviews list is near the bottom of every product page. The small stars near the price and on product cards are a short summary of the same reviews.

09 · Pages

Pages and policies

Text pages like FAQ, Shipping & Returns, and Contact are edited in two ways, depending on the page.

Keep facts in step

If you change a fact like the returns window or the free-shipping amount, update it wherever it appears: the FAQ, the Shipping page, and the theme settings. The manual's chapters point you to each spot.

10 · Going live

Previewing, publishing, and staying safe

Nothing you edit is live until you publish. This is your safety net, so use it.

Preview first

While editing, the right side of the theme editor is a live preview. To see the full store as a shopper would, use the Preview option from the theme's actions. Look at the homepage, a product page, and a category page before you publish.

Publish when ready

  1. In the admin, open Online Store, then Themes.
  2. Find your theme and click Publish. This makes it the live store for everyone.
The Themes page with the live theme at the top and draft themes below
The Themes page. Your live theme sits at the top; drafts are below with a Publish button.
A short don't-touch list

These keep the store working. Avoid them unless you know what you are doing, or ask your developer first.

  • Do not delete the eight category collections.
  • Do not change a category's Conditions. That is what fills it automatically.
  • Do not change a product's handle after it is live, or its links stop working.
  • Leave the Feed source settings on the TikTok and Instagram sections as they are.
  • When unsure, duplicate the theme first, edit the copy, and publish only when happy.
If something looks wrong after publishing

You can re-publish a previous theme at any time from the Themes page. Your older versions stay in the list, so a mistake is always reversible.