1. Documentation /
  2. Lumière Theme

Lumière Theme

Create a stunning website, add an elegant look to your online store and increase conversions with the Lumière theme for WooCommerce — a clean and versatile block theme.


↑ Back to top

Thanks for purchasing Lumière from WooCommerce.com! Each purchase from our site is a yearly subscription which you can view and manage under the My Subscriptions section of your WooCommerce.com account dashboard.

Theme Install and Activation

↑ Back to top

The theme can be installed automatically or manually. We’d recommend one of the automatic options, but if you prefer you can always download the product .zip file and install your purchase manually.

Automatic Installation

There are two ways to automatically install your purchase from WooCommerce.com.

Read more: Automatic Installations

Manual Installation

If you prefer to install your purchase manually, you can certainly do so.

Read more: Manual Installations

Theme Setup Wizard

↑ Back to top

Once activated, you will be redirected to the theme setup page.

You can find the Theme Setup Wizard under Appearance > Theme Setup in case you decide to return to the dashboard and continue with it later on.

1. Child Theme

A WordPress child theme is a theme that inherits the functionality of another theme called the parent theme. Child themes allow you to modify, or add to the functionality of that parent theme.

WordPress Theme Handbook: Child Themes

The setup wizard allows you to build and activate the child theme with no effort.

If you skipped the child theme step, you can manually install the child theme later on.

Just keep in mind that WordPress treats the child theme as a separate theme and hence the Customizer settings will be fresh while switching to the child theme. So, it would appear that you lost the changes you made in the Customizer. However, the settings remain fine in the parent theme’s settings.

You can manually redo the changes or you can use a Customizer import/export plugin to move all the customizer settings from the parent theme to the child theme.

2. Required Plugins

The WooCommerce plugin is required in order for Lumière to work. If the WooCommerce plugin is missing or is not active, theme features and demo import will not be complete.

If you skipped the required plugins step, you can manually install and activate WooCommerce. It can be installed through the WordPress admin dashboard or by uploading the plugin archive through FTP.

Installing WooCommerce through the WordPress admin dashboard

  1. Go to Plugins -> Add New.
  2. Search for “WooCommerce”.
  3. In the search results, click on Install Now.
  4. When the installation is done, click on Activate button.

3. Demo Import

The automatic importer will import posts, pages, products, widgets, menus and Customizer settings. This way it will recreate the minimal theme’s demo setup so you don’t need to start from scratch.

You can select the components you want to be imported from the Advanced list, so you don’t end up with undesired content.

Theme Update

↑ Back to top

Once you connect your site and WooCommerce.com account, you will receive update notifications in your WordPress dashboard as soon as they’re made available allowing you to update the theme with one click or set up automatic updates.

If you still need to manually update your theme, follow the details at Updating Your Theme.

Manage Theme Subscription

↑ Back to top

Read more on how to manage your subscription, transfer a purchase to another account on WooCommerce.com or share the subscription with another account.

Theme Defined Block Patterns

↑ Back to top

Block Patterns are predefined block layouts, available from the block inserter’s Patterns tab. Once inserted into content, the blocks are ready for additional or modified content and configuration.

Lumière theme comes with eight theme-specific patterns:

  • Frontpage
  • About
  • Six different post layouts

Block Editor

↑ Back to top

If you are new to the WordPress Block Editor, here is an article that will show you how to use the it and master it to create visually stunning blog posts and pages:


↑ Back to top

All the theme’s customization settings can be found under Appearance > Customize. This is where you go to upload a logo, change color or fonts.

Missing Options?

We are doing our best to help all our customers and improve their experience with the theme. Let us know if there is something we can improve and we will seriously take into consideration your feedback and suggestions.

Contact Support

Submit a feature request

Site Identity & Logo

↑ Back to top

Under Appearance > Customize > Site Identity you can:

  • Upload a logo and adjust its size
  • Upload a mobile logo and adjust its size
  • Update the site title and the tagline
  • Upload a site icon


↑ Back to top

Under Appearance > Customize > Fonts you can:

  • Choose the headings font family — Lumière supports all fonts on Google Fonts and all web safe fonts.
  • Adjust the headings font weight
  • Choose the base font family — Lumière supports all fonts on Google Fonts and all web safe fonts.
  • Adjust the base font size — The base font size refers to the size applied to the paragraph text. All other elements, such as headings, links, buttons, etc will adjusted automatically to keep the hierarchy of font sizes based on this one size.

Using Web Safe Fonts

Web-safe fonts are fonts that can adapt to any browser on any device. By using these types of fonts, web designers and developers ensure that the intended font will always display properly on a web page, even if these fonts aren’t installed on the user’s computer.

The following fonts are the best web safe fonts for HTML and CSS:

  • Arial (sans-serif)
  • Verdana (sans-serif)
  • Tahoma (sans-serif)
  • Trebuchet MS (sans-serif)
  • Times New Roman (serif)
  • Georgia (serif)
  • Garamond (serif)
  • Courier New (monospace)
  • Brush Script MT (cursive)

Using Google Fonts

Thanks to the Google Fonts library, we have access to a web repository of over 900 quality fonts ready to use. They’re free to use (even for commercial projects), pre-hosted (so they won’t take up your server’s resources), and downloadable (you can use them in print).

How to manually install Google Fonts on your WordPress website:

Step 1: Find the font you want to add to your website

To get started, browse the Google Fonts directory and choose the font you want to use on your WordPress website. If you already have a specific typeface, you can simply search for it using the search box in the right sidebar.

Once you know which font you’re going with, copy its name and return to your website’s Customizer settings.

2. Insert the Google Font’s name into the Base Font Family field

Make sure you use the exact name of the font as it is called in Google Fonts.

Publish your Customizer changes and visit your site. The selected Google Font should now load and apply into your pages.

Using Custom Fonts

In order to use a custom font, you need a plugin that helps you easily embed the custom fonts files (woff2, woff, ttf, svg, eot, otf) in your WordPress website. The Custom Fonts plugin or the Use Any Font plugin should do the trick. Once you successfully embedded the font files, all you need to do it change the font name under Appearance > Customize > Fonts > Base Font Family.


↑ Back to top

The theme’s color palette consists of 6 colors which can be changed via Appearance > Customize > Colors. The colors defined here are being applied automatically across the site.


↑ Back to top

Under Appearance > Customize > Header you can:

  • Adjust the header height by setting the top-bottom header paddings
  • Choose the menu dropdown style (Simple Menu or Mega Menu)
  • Set the sticky header to be visible at all times when scrolling up or down
  • Set the Topbar background and text colors


↑ Back to top

Under Appearance > Customize > Footer you can:

  • Update the Footer Text Note
  • Set different colors for the text and background

Homepage Settings

↑ Back to top

Under Appearance > Customize > Homepage Settings you can:

  • Show/Hide page title on homepage (useful for pages with fullwidth image or slider)


↑ Back to top

Under Appearance > Customize > Shop you can:

  • Add product short description on product listings
  • Set shop pagination (classic pagination or AJAX ‘Load More’ pagination)


↑ Back to top

The theme comes with two menu locations: one for the header area and another one for the footer area.

Menus can be created and assigned their respective menu location via Appearance > Menus.

Read more: WordPress Menu User Guide

Main Navigation

The main navigation is being displayed in the header’s right side on desktop and mobile screens.

Widget Areas

↑ Back to top

The Lumière theme comes with two widget areas: one for the Shop Filters and one for the Footer. Both can be managed via Appearance > Widgets.

Shop Filters

Several widgets come with WooCommerce that help you display products in a multitude of ways. Check the documentation to see what widgets are included with WooCommerce and how to use them:

The footer widget area allows you to set up to 3 widget columns. Additional settings can be found under Appearance > Customize > Footer.

Block-Based Widgets Editor

↑ Back to top

The Widgets Block Editor allows you to insert blocks and widgets into any of the widget areas defined by the theme, via a standalone editor or through the Customizer.

If you are new to the Widgets Block Editor, here is an article that will show you how to use the it and master it to create visually stunning widget sections:

Theme built-in CSS classes

↑ Back to top

Here is a list of theme predefined classes that may help you with a little extra customization when working on your blocks. Simply add them via Block > Advanced > Additional CSS class(es)

.text-lefttext-align: left;
.text-centertext-align: center;
.text-righttext-align: right;
.heading-size-1font-size: {H1 Font Size};
.heading-size-2font-size: {H2 Font Size};
.heading-size-3font-size: {H3 Font Size};
.heading-size-4font-size: {H4 Font Size};
.heading-size-5font-size: {H5 Font Size};
.heading-size-6font-size: {Customizer Base Font Size};
.boldfont-weight: bold;
.uppercasetext-transform: uppercase;
.label-sizefont-size: small;
.meta-sizefont-size: 0.95rem; font-weight: 500;
.half-widthmax-width: 50%;
.no-marginmargin: 0;
.no-margin-leftmargin-left: 0;
.no-margin-rightmargin-right: 0;
.no-margin-topmargin-top: 0;
.no-margin-bottommargin-bottom: 0;
.no-paddingpadding: 0;
.no-padding-leftpadding-left: 0;
.no-padding-rightpadding-right: 0;
.no-padding-toppadding-top: 0;
.no-padding-bottompadding-bottom: 0;
.no-list-stylelist-style: none;
.primary-buttonprimary button styles
.secondary-buttonsecondary button styles
.relativeposition: relative;
.absoluteposition: absolute;
.fixedposition: fixed;
.flexdisplay: flex;
.inline-blockdisplay: inline-block;
.blockdisplay: block;
.hiddendisplay: none;
.leftfloat: left;
.rightfloat: right;
.right-0right: 0;
.left-0left: 0;
.background-colorcolor: {Customizer Color 1};
.text-colorcolor: {Customizer Color 2};
.accent-colorcolor: {Customizer Color 4};
.hover-accent-coloron hover: color: {Customizer Color 4};
.lightopacity: 0.25;
.mediumopacity: 0.5;
.darkopacity: 0.75;