Pepperell Crafts
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.
01 · Getting around
Almost everything visual is edited in one place: the theme editor. Learn these few ideas once and the rest of the guide is easy.
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.
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.
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
A product needs the usual basics, plus a few Pepperell fields that power your category pages, filters, and the specifications table.
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.
| Field | What it does | How to fill it |
|---|---|---|
| Main category | Decides which of your eight category pages the product appears on. This is the most important field. | Type one of the eight values below, exactly. |
| Material | Shows in the specifications table and powers the material filter. | Pick one or more from the dropdown. |
| Skill level | Used on kits to show and filter by difficulty. | Pick Beginner, Intermediate, or Advanced. Leave blank for non-kit items. |
| Audience | Optional grouping, for example Kids or Adults. | Pick from the dropdown if it applies, otherwise leave blank. |
| Project | What 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.
Type the category exactly as one of these, including the punctuation, or the product will not appear on its category page:
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.
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.
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.
03 · Homepage
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.
| Section | What you control |
|---|---|
| Announcement bar | The 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 hero | The big opening headline, its buttons, the moving wall of products behind it, and the four small stats. |
| Shop by category | The grid of your eight category cards. |
| Featured collection | A row of products, used for Best sellers and for Kits. |
| Heritage block | Your story section with a photo and text. |
| Trust strip | The row of reassurances, for example returns and secure checkout. |
| Testimonials | The customer reviews heading and intro. |
| Featured blog | The latest posts from your blog. |
| TikTok feed | Your 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 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.
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
The Best sellers and Kits rows on the homepage are both the Featured collection section. You choose which products show, in what order.
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
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).
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.
07 · Brand
Store-wide choices live in one place. In the theme editor, click the gear icon for Theme settings.
| Group | What's inside |
|---|---|
| Colors | Your brand orange, cream, and text colors. The main orange drives buttons, the top bar, and links across the whole store. |
| Typography | The heading and body fonts, and a slider to make all text a little larger or smaller. |
| Cart | Whether 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 links | Your Instagram, Facebook, YouTube, Pinterest, and TikTok links. A blank field hides that icon. |
| Store details | Your public phone number, email, and short location line, shown in the footer and contact areas. |
| Product display | Optional switches for badges, gift wrapping, delivery estimates, and which specification rows to show. |
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
Reviews are handled by the Judge.me app. They appear on each product page and as star ratings on product cards.
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
Text pages like FAQ, Shipping & Returns, and Contact are edited in two ways, depending on the page.
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
Nothing you edit is live until you publish. This is your safety net, so use it.
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.
These keep the store working. Avoid them unless you know what you are doing, or ask your developer first.
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.
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
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.