---
title: Install Gemelune
description: Requirements, installing the theme, and the Appearance → Gemelune setup checklist.
url: "https://wpruby.com/knowledgebase/gemelune-installation/"
updated: "2026-11-04"
category: WPRuby Themes / Gemelune
---

# Install Gemelune

Table of Contents

 [Toggle](#)

- [Requirements](#Requirements)
- [Install](#Install)
- [The setup checklist](#The_setup_checklist)
- [Customizations that survive updates](#Customizations_that_survive_updates)

## Requirements

|  | Minimum | Tested up to |
| --- | --- | --- |
| WordPress | 6.7 | 7.1 |
| PHP | 7.4 | – |
| WooCommerce | 9.6 | 11.2 |

## Install

1. Download `gemelune-<version>.zip` from your [WPRuby account](https://wpruby.com/my-account/). Don't unzip it.
2. In WordPress, go to **Appearance → Themes → Add New Theme → Upload Theme**.
3. Choose the ZIP, click **Install Now**, then **Activate**.
4. Install and activate **WooCommerce** if it isn't active yet.

## The setup checklist

**Appearance → Gemelune** is the theme's own screen. It starts with a checklist that ticks itself off as your store takes shape:

| Step | Done when |
| --- | --- |
| Activate WooCommerce | WooCommerce is active |
| Add your pieces | You have at least one published product |
| Add your logo | The site has a logo (without one, the site title is set as a wordmark) |
| Write your information pages | Your size guide, delivery and care pages are published. See [Information pages](https://wpruby.com/knowledgebase/gemelune-information-pages/) |
| Check your metal swatches | Every metal and colour has a swatch colour. See [Swatches](https://wpruby.com/knowledgebase/gemelune-products/#swatch-colours) |
| Turn on a payment method | A payment method is enabled |
| Set up shipping | You have a shipping zone |
| Connect a newsletter | Optional: a newsletter plugin such as MailPoet is connected. See [Newsletter](https://wpruby.com/knowledgebase/gemelune-homepage/#newsletter) |
| Activate your licence | Optional: your licence is active |

Each step has a button that takes you to the right screen.

[![The Appearance → Gemelune screen with the setup checklist](https://cdn.wpruby.com/wp-content/uploads/2026/11/04092257/gemelune-docs-admin-hub.jpg)](https://cdn.wpruby.com/wp-content/uploads/2026/11/04092257/gemelune-docs-admin-hub.jpg)

The same screen has shortcuts into the Site Editor, a preview of every [style variation](https://wpruby.com/knowledgebase/gemelune-styles/), the [starter sites](https://wpruby.com/knowledgebase/gemelune-starter-sites/), the [licence](https://wpruby.com/knowledgebase/gemelune-licence/) and help links.

## Customizations that survive updates

Changes you make in the Site Editor are saved in your site's database, so theme updates don't overwrite them. For custom CSS, templates, patterns or PHP in files, use the [child theme](https://wpruby.com/knowledgebase/gemelune-child-themes/).