Pepperell Crafts
Two plain-language guides in one place. The user guide shows you how to run the Pepperell Crafts theme yourself: adding products, editing the homepage, curating collections, and publishing. The deployment guide walks through how your new store goes live, stage by stage, and what you and your shoppers see at each step.
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.
The plan · Going live
Your new store is an upgrade to the store you already have, not a new one. Same web address, same orders, same customers. We add the new look and the new organization on top, then flip the switch when you are ready. Here is the plan, stage by stage, with what your shoppers see and what you see in the admin at each step.
Everything is built and checked while your current site keeps running as normal, so there is no downtime and nothing to rush. The new design only becomes public the moment you choose to publish, and that same switch can be flipped back in one click.
We copy the finished Crafts theme onto your live store, but leave it unpublished so it stays private.
Nothing changes. Your current site stays open for business and looks exactly as it does today.
A new draft theme in Online Store, Themes, sitting below your live one. You can preview it privately, but it is not public until it is published.
We duplicate the draft so you have a sandbox to click around in, learn the editor, and try things without any worry.
Nothing changes. This copy is private to you.
A second draft theme to open in the editor and change freely. Anything you do to it stays private, so you cannot affect the live site. The user guide tab walks you through the editor.
While you get comfortable, we update the writing on the About, Shipping and Returns, FAQ, and Contact pages. Your product descriptions stay as they are for now.
The new page wording appears on your current site right away. Page text is shared across themes, so it updates the moment we save it. Product pages are untouched.
Nothing to do. We handle the page text. You will see the new wording if you open those pages in the admin or on the site.
We add the Main category and the other craft fields to every product, create the eight category pages, and turn on the shopper filters. Prices, photos, and descriptions are left exactly as they are.
This step makes no visible change on its own. The craft fields and the new category pages stay behind the scenes until the new theme goes live, so your current site keeps working as normal.
The craft fields fill in on your products, and the eight category collections appear. This is the groundwork that makes categories, filters, and the specifications table work the moment we publish.
You preview the new design on your own store, tell us what to adjust, and decide when it feels right. There is no deadline.
Still your current site, running as usual.
The draft theme to preview: walk the homepage, a product, and a category page, and send us any changes. Nothing goes public until you say so.
When you are happy, we publish the new theme. This is the one visible switch, and it is instant with no downtime.
The new Crafts design: the eight categories, working search, and real customer reviews from Judge.me. Their carts and accounts carry on without interruption.
One click publishes the new theme, and your old theme stays in the list so going back is also one click. At this moment we reconnect the review widgets and the tracking tags to the new theme, since those do not carry across on their own, and we confirm they are working.
Once you have approved the catalog changes, we bring over the rewritten product titles and descriptions, so the live store matches the test site in full.
The new product titles and descriptions on every product page.
The new copy in place on your products. This phase adds to what is already there, so nothing breaks, and we run it on your go-ahead.
The reassuring part. Through every stage above, the parts of your store that matter most are left alone.
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.