FAQ — Scruff docs

Products, photos and the demo text aren't there after I install

They aren't included. The demo stores in the listing photos use our own sample products and pictures. Your products appear as soon as you add them, and sections that need a product, collection or image show samples in the theme editor until you choose one.

I don't see any "Fits" badges

Badges need three things: a pet saved in the browser you're looking with (click Add your pet in the header), products with an option named in Size option names ("Size" by default), and size names that match Weight range per size (XS, S, M, L, XL by default). Also check Show fit badges on product cards is on (chapter 8).

Every product says "Check size"

The product's size names don't match the labels in Weight range per size, or its custom.size_weights: "Medium" isn't "M". Rename the option values, or write your ranges with your own size names (chapters 7 and 8). "Check size" also means the size that would fit is sold out.

A 4 kg dog shows S, not XS

That's on purpose: a weight exactly on a boundary goes to the larger size, so between two sizes the pet sizes up (chapter 8).

A product for cats shows no bone for my dog

Its custom.species is Cat, so dogs get no verdict and the fit switch hides it from dog owners. Leave the species empty, or add both Dog and Cat, for products that suit both (chapter 7).

The fit switch hid a product that has no sizes

It hides products for the other species. A product with no sizes stays only when it's for the shopper's species or has no species (chapter 8).

"Only what fits" shows only a few products, but the collection has more

The switch filters the page that's open, not the whole collection: other pages aren't checked, and it says "Filtering this page only." Raise Products per page in the Collection section, or use smaller collections (chapter 8).

Dogs / Cats / All doesn't appear on my collection

It shows only when Show the Dogs / Cats / All filter is on and at least one product on the page has a custom.species. To filter whole collections by species, add the Species filter in Search & Discovery (chapter 13).

Can I see my customers' pets?

No. The profile stays in the shopper's own browser and is never sent to you, to Shopify or to anyone else. That's also why a shopper adds their pet again on another device (chapter 8).

Will the theme email shoppers before their pet's birthday?

No. The banner on your site in the week before the birthday is the whole reminder. Nothing is emailed, because the theme doesn't know who the shopper is (chapter 8).

The cat shop's pet dialog starts on Dog

Set Default species to Cat in Theme settings › Pet profile: the dialog from the header, the Pet profile section's form (left on Same as theme settings) and the theme editor's sample pet all start on Cat. The Whisker preset already does (chapter 8).

The size guide link is missing

The product needs a size option (named in Size option names) or its own custom.size_table, the template needs the Size guide block (product.tag and product.food don't have it), and there must be a table: check Default size table isn't empty (chapter 9).

The size guide's table says a different size from its suggestion

The suggestion and the fit badge both use custom.size_weights or Weight range per size; the table shows its own weight column as written. Make the two agree, and give a product with its own size weights its own size table too (chapter 9).

A breed gives no suggested row

The breed's size isn't one of the sizes in the table shown, or is written differently. Check the breed's line in Breeds uses your own size names (chapter 9).

The name tag preview doesn't show on my tag

With Only on tagged products on (the default), the product needs the tag personalise (or your Product tag), and the template needs the Name tag preview block: give the product product.tag (chapter 10).

The preview shows the wrong shape or finish

The product's option names must match Shape option name ("Shape") and Finish option name ("Finish"), and the values must contain Bone, Round or Heart, and brass, gold, silver, steel, rose or black. Otherwise the block's fixed shape and finish are used (chapter 10).

There's no fee on my engraved tags

That's by design: engraving is included on tags, and only embroidery adds the fee product. Price your tags to include engraving (chapter 10).

The embroidery fee doesn't appear

Choose the fee product in Theme settings › Personalisation, and check it's Active and published to the Online Store sales channel (chapter 10).

A tag order came through without engraving

It was added from a card's quick add or from quick view, which don't personalise, or from a Quick order list. Turn off quick add and quick view if you sell tags, and keep the Quick order list off product.tag (chapters 6 and 10).

Where do I see the engraving on an order?

In Shopify admin, open the order: the properties are under the item's name, as Tag front, Tag back, Tag font, or Embroidery and Thread (chapter 10).

There's no Buy it now button on my tags

It's hidden while personalising, on purpose: Buy it now skips the bag and would lose the engraving (chapter 10).

The feeding calculator doesn't show

The product needs a custom.feeding_guide metafield with weights and grams, and the template needs the Feeding calculator block: give the product product.food (chapters 7 and 11).

The calculator gives the daily amount but not how long the bag lasts

The selected variant has no custom.net_grams. It's a variant metafield: fill it in on each bag size (chapter 7).

The daily amount looks far too high or too low

Check the feeding guide's weights are in kilograms and its amounts in grams per day, one plain number each (chapter 7).

No delivery plan is chosen

The product has no plans (they come from a subscription app), the variant has no custom.net_grams, Preselect the closest plan is off, the shopper already chose an option, or the plan names have no number of weeks and Weeks per delivery plan doesn't match them (chapter 11).

The wrong plan is chosen

A plan named by month ("Every month") takes its weeks from Weeks per delivery plan by its place in the list. Rename your plans in weeks, or set the setting to match their order, such as 4, 8 (chapter 11).

Choose a Product in the section, one that has a feeding guide (chapter 11).

Shop by size shows everything, not one size

Add the Size filter in Search & Discovery, or give each tile its own link (chapter 13).

The product page says "Free shipping over $79." and I don't offer it

The Scruff and Whisker presets set Theme settings › Commerce › Free shipping over. Set it to 0, or to your real threshold (chapter 2).

The theme doesn't create discounts or send email. Set up the discount and the welcome email in Shopify, or change the Newsletter section's words (chapter 4).

The footer's About column is missing

It shows a menu with the handle about, which a new store doesn't have. Create the menu in Content › Menus, or choose another menu in the column (chapter 3).

My card shows no quick add button

Turn on Show quick add button in Theme settings › Product cards. Sold-out products never have one, and products with options open quick view.

Can I use Scruff on more than one store?

Each purchase covers one store. Buy a licence for each additional store (see LICENSE.txt).

How do I update to a new version of Scruff?

Updates are provided at Buglyph's discretion and download the same way as your original purchase. Upload the new zip as a new theme and set it up alongside your live one before publishing. Your metafields, products, collections, menus, pages, subscription plans and Search & Discovery filters live in your store, not the theme, so they carry over. Theme editor changes, including your weight ranges, size table, breeds, threads and fee product choice, need to be made again in the new copy. Your shoppers' saved pets stay in their browsers and carry over too.

Does Scruff need any apps?

No app is needed for the pet profile, the size guide, the name tag and embroidery preview, or the feeding calculator. Delivery plans for autoship need a subscription app, such as Shopify's free Shopify Subscriptions. Shopify's free Search & Discovery app powers the Size, Species and Colour filters and the complementary products, and its free Translate & Adapt app handles other languages. Star ratings need a review app.