Purlia

Purlia is a WordPress block theme for yarn, knitting and crochet stores. This guide explains how to install the theme, choose a homepage, add your own content and prepare your store for customers.

Before you begin: back up your website and try changes on a staging copy if your store is already trading. Theme activation does not import demo products, connect services or change your store settings.

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the โ€œAdd to storeโ€ functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product youโ€™re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Requirements

↑ Back to top
  • WordPress 6.7 or later.
  • PHP 7.4 or later. Use a maintained PHP version supported by your complete website.
  • WooCommerce 9.9 or later for products, cart, checkout and customer accounts. WooCommerce has its own WordPress and PHP requirements.
  • An administrator account to install themes and plugins.

Purlia uses the native WordPress Site Editor. You do not need a third-party page builder.

Install Purlia

↑ Back to top
  1. Download the installable purlia.zip file from your WooCommerce.com account.
  2. In your WordPress dashboard, go to Appearance > Themes > Add Theme > Upload Theme.
  3. Choose purlia.zip and select Install Now.
  4. When installation finishes, select Activate.
  5. Install and activate WooCommerce separately if the website will sell products. Complete its store setup.

Upload the installable theme ZIP, rather than a package containing documentation or multiple ZIP files. Installing the theme alone does not recreate the demonstration store.

Choose a homepage

↑ Back to top

Purlia includes four homepage layouts. Create or select a published page, then go to Settings > Reading. Select A static page and choose your homepage. Select a separate posts page, such as Journal, if you want a blog. Save your changes.

Home 1

↑ Back to top

Home 1 uses the Front Page template. Open Appearance > Editor > Templates > Front Page. Use List View to find its hero, category cards, product collections and other sections. Edit the text, links and images, then save. Editing the Home page body in Pages does not change this template’s content.

Home 2, Home 3 and Home 4

↑ Back to top
  1. Open Pages > Add New and name the page.
  2. Use the block inserter’s Patterns tab to choose the matching Purlia homepage pattern.
  3. Choose the corresponding Home 2, Home 3 or Home 4 template in the page settings.
  4. Replace the sample text, images and links, then publish the page.
  5. Select it as your homepage in Settings > Reading.

Detailed walkthrough: Purlia homepage guide.

Set your branding, colors and navigation

↑ Back to top
  • Store name: update the Site Title in Settings > General.
  • Colors and fonts: open Appearance > Editor > Styles. Choose Colors or Typography, preview the changes and save.
  • Header and footer: open Appearance > Editor > Patterns > Template Parts. Choose Header or Footer and edit its blocks.
  • Menus: select the Navigation block in the header. Add, rename or remove links and edit Home or Shop submenu items. Check that every link points to your own site.

WordPress menu labels can differ by version. Use List View to select blocks inside a larger layout. Review text contrast and mobile navigation after changing the design.

Replace images from the Media Library

↑ Back to top
  1. Open the page or template that contains the image.
  2. Select its Image block, using List View if needed.
  3. Choose Replace > Media Library, or upload your own image.
  4. Add useful alternative text when the image communicates information.
  5. Save and check the page on desktop and mobile.

Shared shop and account photographs have named template parts: Shop feature image, Account welcome image and Account dashboard image. Product photographs are managed in the product editor; blog covers use Featured Images.

The installable theme does not bundle content photographs. Empty image placeholders are expected until you choose Media images or import optional sample content. See Images & Media Library.

Add products and color options

↑ Back to top

Go to Products > Add New. Add a product name, description, category, product image and any gallery images. For a simple product, set a price and stock availability, then publish.

Create global attributes

↑ Back to top

Open Products > Attributes. Purlia uses the following global attributes for its yarn presentation and filters:

  • Color, with slug color.
  • Fiber, with slug fiber.
  • Yarn weight, with slug yarn-weight.

Choose Configure terms to add values. For each Color term, set its Swatch color. Assign these global attributes to your products. A per-product text attribute named Color does not replace the global Color attribute used by the filters.

Create a variable product

↑ Back to top
  1. Choose Variable product in Product data.
  2. In Attributes, add the global Color values you sell and enable Used for variations. Save the attributes.
  3. Open Variations and create the combinations you intend to sell.
  4. Give each variation a price and an available stock status. Add a variation image if the shade needs different photography.
  5. Optionally choose a default color. Publish and test each selection on the product page.

Color swatches do not recolor a photograph. Upload the appropriate picture for each variation that needs its own image. Add specifications such as skein size, length, needles and gauge using product attributes.

See Catalog and product setup for illustrated instructions.

Configure cart, checkout and customer accounts

↑ Back to top

In WooCommerce > Settings > Advanced, confirm that Cart, Checkout and My Account point to the correct pages. Retain the native WooCommerce Cart and Checkout blocks. The My Account page uses WooCommerce’s native account output.

To show a Register form, open WooCommerce > Settings > Accounts & Privacy and allow account creation on the My Account page.

Purlia supports AJAX add to cart for standard simple and variable product forms and opens the cart drawer after a successful addition. Product stock, prices, totals and checkout validation remain managed by WooCommerce. Grouped products, external products and forms with additional extension fields can retain normal submission.

Shipping and payment

↑ Back to top
  • Configure the regions and delivery methods you offer in WooCommerce > Settings > Shipping.
  • Set up tax and a payment gateway for your business.
  • Test using the gateway’s test mode before accepting real payments.
  • Update your Shipping & Returns page and header announcement to match your actual policies.

A free-shipping announcement is editable text; it does not create a shipping rule. Set up the corresponding method and threshold in WooCommerce.

Build your other pages

↑ Back to top

Use Purlia page patterns and matching templates for About, Contact, Shipping & Returns, Order Tracking and the pattern project library. Replace all sample contact details and policy wording with your own.

For your blog, choose a posts page in Settings > Reading. Add articles under Posts and choose a Featured Image for each one. Manage comments and pagination under Settings > Discussion; review product reviews after changing those settings.

The Patterns page is a project library. Demo project notes are illustrative examples, not professionally tested downloadable patterns. Supply your own licensed files and accurate project instructions before selling downloads.

Optional newsletter, contact forms and wishlist

↑ Back to top

Newsletter

↑ Back to top
  1. Install and activate MC4WP: Mailchimp for WordPress.
  2. Enter your own API key directly in its WordPress settings. Do not share the key in public support requests.
  3. Create a signup form, choose the intended Mailchimp Audience and review the confirmation options.
  4. Edit the Footer in the Site Editor and select your form in its MC4WP block.
  5. Test signup using an email address you control and check the result in Mailchimp.

A sample form ID does not connect your Mailchimp account. If the form is unavailable, the footer can show an availability message.

Contact forms

↑ Back to top

Install WPForms separately if you want to use its styled form. Create the form, configure its notification recipient and select it in the Contact page’s WPForms block. Send a test message and confirm delivery. Form email delivery depends on WordPress and your email setup.

Wishlist

↑ Back to top

The Purlia Wishlist plugin is an optional, separate plugin and is not bundled in the theme ZIP. Use it only if it has been supplied and installed separately.

More details: Optional integrations guide.

Optional demo content

↑ Back to top

Theme activation does not import a demo. If you have received the separate demo-content materials, follow the demo import guide on a clean staging site. Do not import a sample catalog over a trading store.

Some optional offline import or older-demo migration workflows need command-line access. Ask your host or developer to run the supplied steps if you are unfamiliar with these tools. You can also build the pages with the included patterns and select your own Media images.

Updates and troubleshooting

↑ Back to top
  • Before updating: back up your database and files, test the update on staging, then review key pages and checkout.
  • Missing stylesheet error: upload the installable purlia.zip rather than the complete download package.
  • Home 1 changes do not appear: edit the Front Page template in the Site Editor.
  • Missing images: choose images from your own Media Library. Theme installation alone does not import photos.
  • Missing color choices: check the global Color attribute, assigned terms, variation prices and stock.
  • Newsletter unavailable: check MC4WP connection, Audience and the form selected in the Footer.
  • Shipping methods missing: check the delivery address, shipping zones and whether the product is marked Virtual.
  • Page not found after migration: review Settings > Permalinks and save the intended structure.

If a layout differs after an update, review any saved template or block customizations. Avoid editing the theme’s original files; updates can replace them. A developer can use a child theme for code changes.

Before opening your store

↑ Back to top
  1. Replace sample text, photographs, contact details and policy wording.
  2. Check menus, product categories, prices, variations and stock.
  3. Test the storefront on desktop and mobile, including keyboard navigation.
  4. Test cart quantities, coupons, shipping and checkout with a test payment method.
  5. Check registration, password recovery, contact messages and newsletter confirmation.
  6. Review your privacy, shipping, returns and terms pages.

Get help

↑ Back to top

Read the complete Purlia guide for screenshots and additional walkthroughs. For product support, use the support channel available from your WooCommerce.com account.

Include your theme, WordPress and WooCommerce versions, the affected page, steps to reproduce the issue and a screenshot. Never send passwords, payment details or API keys in a public request.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.