Gemma Oro documentation
Everything you need to set up and run your store with Gemma Oro 1.0.0. Questions this page does not answer? Contact support.
Getting started
Gemma Oro is a Shopify theme for fine jewelry and accessories brands: rings, necklaces, earrings and bracelets in precious metals and stones. Its "jewel box" product cards, oval collection frames and metal swatches put small, precious products first, on a fast and accessible storefront.
Install the theme
- In your Shopify admin, go to Online Store > Themes.
- Find Gemma Oro in the Theme Store and click Try theme or Add theme.
- Click Customize to open the theme editor. Your theme stays unpublished until you click Publish.
Before you start
- Create your menus in Content > Menus: a Main menu (up to three levels), a Footer menu and, for the collection banner, a menu of your main collections.
- Photograph pieces in a consistent ratio. Portrait 4:5 photos (for example 1600 x 2000px) look best; use a close-up as the second photo, it shows on hover.
- Add a Material metafield for products: Settings > Custom data > Products > Add definition, name Material, namespace and key
custom.material, type Single line text (for example "14k yellow gold, diamond"). Cards show it under the title. - Set metal and stone colors as option swatches (Products > Options) so cards, product pages and filters show them as colored discs.
- Install the free Search & Discovery app to set up filters (for example Metal) and product recommendations.
Colors and palettes
Gemma Oro uses color schemes. Every section has a Color scheme setting, so you can recolor one section without touching the rest.
Ready-made palettes
Go to Theme settings > Colors > Color palette and choose one of eleven palettes: Gemma Oro, Meridian, Atelier, Bloom, Volt, Harvest, Haven, Summit, Studio, Vitality and Craft. A palette recolors the first five color schemes, and with them the whole store, in one step.
Show palette picker to visitors adds a small bar at the bottom of the store where visitors can try every ready-made palette; their choice is kept only in their own browser and changes nothing in your store. Use it on preview or demo stores and keep it off for selling.
Choose Custom color schemes to set every color yourself. Each scheme has a background (or gradient), text, heading, accent, button, button label and border color.
Badges
Set the colors of the sale, sold out and product tag badges under Colors > Badges. Add a tag such as badge:New to a product to show a New badge on its card.
Typography
Choose a heading font and a body font in Theme settings > Typography. Both use Shopify's font library, so they load from Shopify's servers and stay fast.
- Font size scale makes headings or body text larger or smaller across the store.
- Emphasized words: in any heading, select words and press Italic in the editor. They show in the accent color of the section's color scheme. Turn on Show emphasized words in italic to set them in italic too; it is off by default.
- Letter case sets headings, navigation and buttons to uppercase or default case.
Header, menus and search
Announcement bar
Add up to six announcements. They rotate automatically and pause when customers hover or focus them. The bar can also show a link, social media icons and the country and language selectors.
Header
The header has two rows: a top row with a search field, your logo (with an optional Tagline under the logo), the account icon and the bag, and a menu row below it with small dots between the items.
- Sticky header: None, Menu row (the top row scrolls away and the menu row stays, with the Short logo on one side and a small bag on the other) or Whole header.
- Show transparent header on home page: the header sits over the first section when it is a full-width slideshow or image banner, and turns solid when customers scroll.
- Customer accounts: the account icon uses Shopify's account component. It shows when customer accounts are turned on in Settings > Customer accounts.
Menu trays
Every main menu item with links below it opens a tray under the menu row. Items with their own links become columns; single links are listed under the Heading of single links in menu trays (for example "Shop by type"), with a link to the whole collection at the end.
- Swatch link blocks add round color swatches to a tray, for example Shop by metal (yellow, white and rose gold discs) or Shop by stone (small dots). Enter the Menu item exactly as it appears in the main menu; blocks with the same Group heading form one column. Each swatch has a color or an image and its own link.
- Menu image blocks add pictures with a heading and a link text to a tray (up to twelve images in all).
Trays open on hover (Open menus on hover) or on click, dim the page behind them and work with the keyboard: Enter opens, Tab moves through the links, Escape closes. On phones the menu is an accordion with the swatches and images of each item inside it.
Search
The search drawer suggests products, collections, pages and articles as customers type. Before they type it shows the Popular searches menu (Theme settings > Search behavior) and products from the collection you choose in Featured products collection. In languages for which Shopify has no suggestions, the drawer offers a link to the full search page.
Home page sections
| Section | Use it for |
|---|---|
| Slideshow | Image and panel: the photo on one side and the text on a colored panel, with numbered dots and, in each slide, an optional Product shown as a small "featured piece" card. Full-width image: text over the photo. Separate mobile images, auto-rotation with a pause button. |
| Collection list | Collections in Oval frames (Image shape) with a ring that takes the accent color on hover, or in rectangles; as a grid or a slideshow, with product counts. On phones the ovals scroll sideways. |
| Featured collection | Products from one collection. Add more collection blocks and they become pill-shaped tabs (for example New in, Bestsellers, Under $200). |
| Material guide | One card per metal or material with a polished swatch disc (two colors blended, or an image), a short text and a link; a soft light crosses the disc on hover. |
| Story with collage | Your studio story: three overlapping pictures, a heading, text, up to four Fact blocks with icons and a button. |
| Image with hotspots | Pin products to a photo so customers can shop the whole look, with the total of the look. |
| Image banner | One large image with text on it, or with the text on a card (Text style: Text on a card, with its own Card color scheme). |
| Blog posts | Latest articles in a grid or an editorial layout. |
| Email signup | Text beside the form or Centered, with a pill-shaped form. Subscribers are added to your customer list. |
| Icons with text, Scrolling text, Testimonials, Featured product, Image with text, Map, Rich text, Video, Collapsible content, Recently viewed | Promises, a moving line of messages, customer quotes, one product with its buy buttons, your story with numbers, your physical store, text, videos, questions and answers, and products the customer viewed. |
| Press | What magazines and newspapers wrote about you: one quote at a time, with the publications' names or logos as tabs below it. |
| Before and after | Two pictures of the same size on top of each other, with a handle customers drag (or move with the arrow keys) to compare them. |
| Countdown | A band that counts down to your own date and time. It never starts again; after the date it hides or shows your closing text. |
| Quick order list | Every variant of one product in rows with a quantity field and one button that adds them all, for wholesale and bulk buying. |
| Custom Liquid, Apps | Your own code and app blocks. |
Product page
Every element of the product page is a block you can add, remove and reorder: vendor, title, rating, price, variant picker, size guide pop-up, inventory status, quantity, buy buttons, icons with text, description, collapsible rows, complementary products, share, Custom Liquid and app blocks.
- Engraving block: an optional text field that opens under its heading, with a character counter. What the customer types is added to the order as a line item property under the Name shown in the cart and order; set the Maximum characters (4 to 40). It is hidden on gift cards.
- Swatches (variant picker Swatch: Swatch with name, Circle or Square): the default shows each metal or stone as a polished disc with its name in a pill.
- Swatches: set colors or images for option values in Products > Options (category metafields). The variant picker shows them as swatches.
- Gallery layout (section setting Desktop media layout): Carousel with a row of thumbnails beside the image, Slider with thumbnails below, or Grid. The carousel has arrows, an image counter and, on phones, a swipe with a progress line.
- Magnifier (Magnify images on hover): on computers, a sharp close-up follows the pointer over the image. It also works in quick view and in the Featured product section.
- Full-screen viewer (Open images in a full-screen viewer): swipe or use the arrow keys between images; zoom with pinch, double-tap, the mouse wheel, the + and − buttons or keys, and drag to move around a zoomed image. Upload images at least 2000px wide so zoom stays sharp.
- Variant images: assign an image to each variant. It moves first in the gallery when the variant is chosen.
- Show only the selected color's media (Show only the media of the selected color): assign an image to the first variant of each color and place that color's other images right after it in the product's media. The gallery then shows only the images of the chosen color; images before the first variant image are shown for every color.
- Media: videos, YouTube and Vimeo videos and 3D models are supported, including "View in your space" on supported phones.
- Back in stock request (Buy buttons block, Show back in stock request): when the chosen variant is sold out, customers can leave their e-mail. It arrives as a contact message naming the product and variant, so no app is needed; you answer when the product is back.
- Delivery estimate block: shows "Get it between …" from your own processing and shipping days, skips weekends if you choose, and can show the order cut-off time for same-day dispatch in the customer's own time zone. It is calculated from your settings only; it never counts down.
- Size guide: create a page with your size table and choose it in the Pop-up block.
- Purchase options: products sold with selling plans (subscriptions or pre-orders from a Shopify app) show a one-time purchase and each plan with its own price. The chosen option stays when the customer changes the size or color.
- Pre-order (Buy buttons block, Show Pre-order for items sold while out of stock): when a variant tracks inventory, has none left and is set to Continue selling when out of stock, the button reads Pre-order, a note says it ships once restocked and the stock line reads Available to pre-order.
- Volume pricing and quantity rules (Shopify B2B): the minimum, maximum and steps of a variant and its price at each quantity show under the price.
- Combined listings (Shopify Plus): when an option value stands for another product, choosing it loads that product in place.
- Countdown block: counts down to a real date of yours, for example the end of an offer, in your store's time zone. It never starts again by itself and hides (or shows your closing text) once the date has passed.
- Pickup availability shows when local pickup is set up in Settings > Shipping and delivery.
- Shop Pay Installments shows under the price when Shop Pay Installments is turned on.
- Inventory status shows real stock levels for products whose inventory is tracked. Gemma Oro never shows invented stock, and its countdowns count only to a date you set.
- Gift cards can be sent to a recipient on a chosen date with a message.
- The sticky add to cart bar appears when the main button scrolls out of view.
Collection and search pages
- Filters come from the Search & Discovery app: availability, price, product type, vendor, variant options and more. Color filters show as swatches. On desktop they sit in a sidebar or a drawer; on mobile they open in a drawer.
- Sorting, a switch between grid sizes, and Load more, Infinite scroll (the next products load as customers reach the end; the button stays for keyboards) or page numbers.
- Promotion blocks place an image tile between products on the first page.
- The Collection banner layout Text beside collection shortcuts shows the title and description beside up to four oval shortcuts: the first four links of the Collections menu you choose, with their collection images. Under the description, Quick filter shows the values of one filter as buttons (enter its name, for example Metal; filters are set up in the Search & Discovery app). Other layouts:
- The Collection banner shows the collection image and description, and a menu of collections as buttons. Full width image places the text over the image; Text beside image puts them side by side. The image is cropped to fit, never stretched: set its focal point in Content > Files to choose the part that stays in view.
- Color swatches on product cards (Theme settings > Product cards > Show color swatches): pointing at a swatch shows that color's image, and clicking it opens the product with that color chosen.
- Quick view opens the gallery, options and buy buttons in a pop-up without leaving the collection.
Product cards
Gemma Oro's product card is a "jewel box": the photo sits in a softly tinted frame, title and price share a line, and an always visible Quick add link sits below. Settings are in Theme settings > Product cards.
- Line under the title: Material (from the
custom.materialmetafield, or the product type when it is empty), Product type or None. - Show light sweep on hover: a soft band of light crosses the photo once when customers point at it.
- Show color swatches: up to four metal or stone swatches ride on the photo in a frosted pill; pointing at one shows that variant's photo.
- Show second image on hover, Image ratio, Badge position and Sale badge text work as in every Dart Design theme.
Cart
- Cart type: drawer or page. The drawer opens when customers add a product.
- Free shipping threshold: enter an amount to show a progress bar. It shows only when the cart is in your store's currency, so the amount is always exact.
- Order notes, discounts, unit prices, subscriptions (selling plans) and accelerated checkout buttons are supported.
- Gift wrapping (Theme settings > Cart > Gift wrapping product): create a product such as Gift wrapping with its price, then choose it here. Customers add or remove it with a box in the cart summary.
- Product suggestions in the cart drawer come from Shopify's product recommendations.
- The cart page shows the items beside an order summary that stays in view: free shipping progress, subtotal, order note, checkout and accelerated checkout buttons, and your payment icons (Show payment icons). Add up to four Reassurance blocks under the summary, for example secure checkout or free returns; describe only promises your store keeps.
- The Cart recommendations section suggests related or complementary products for the first item in the cart and leaves out products already in the cart.
- Items slide in when added and fade out when removed, and the free shipping bar fills as the cart grows.
- When the cart is empty, the page shows ways back into the store and products from the collection chosen in Theme settings > Cart.
- The checkout is styled in Settings > Checkout > Customize, not by the theme. To match Gemma Oro, use the colors of your first color scheme (background, text, accent and button), the same heading and body fonts as the theme, and square corners if your buttons are square.
Contact, search and other pages
- Contact page: the Contact form section can show the page title and text beside an image, with up to four Contact detail blocks (address, opening hours, phone or e-mail, reply time). Turn on Show page title and content on the contact page template.
- Extra form fields: add Form field blocks to the Contact form section for an order number, a date, a list of choices, a yes or no box and more. Each answer arrives in the e-mail under the field's label; fields can be required and half width.
- Promotion pop-up and age verification: add them in the theme editor under Overlays (both are off until you add them). The pop-up opens after the page has loaded and the delay you choose, never over another window, and not again for the number of days you set; it can show a discount code to copy and an e-mail signup. The age check asks visitors to confirm their age before they use the store and remembers the answer on their device.
- Back to top (Theme settings > Navigation): a round button appears after customers scroll down a few screens.
- No search results and page not found: both show your Popular searches menu as buttons and products from the collection you choose in the section (Products to suggest), so customers always have a way forward.
Languages and right-to-left
Gemma Oro includes translations for English, French, German, Spanish, Italian, Arabic and Hebrew. Add more languages and edit any text with the free Translate & Adapt app.
Right-to-left languages (Arabic, Hebrew, Persian, Urdu and others) are supported throughout: the layout, menus, drawers, sliders and icons mirror automatically when the store language is right-to-left.
Customers choose their country and language with the selectors in the announcement bar, the footer and the mobile menu. Set up countries and languages in Settings > Markets and Settings > Languages.
Speed and accessibility
Gemma Oro is built without libraries or frameworks. Scripts load only on the pages that need them, images are responsive and lazy-loaded below the first screen, and slideshow images load only when their slide is shown.
In Lighthouse tests on a real Shopify store, the theme scores 96–100 for performance on computers and 97–100 for accessibility on the home, collection and product pages. Phone scores change from run to run because of the scripts Shopify adds to every store; the theme's own scripts take less than 50 ms of the phone's time. Every control can be used with a keyboard, focus is always visible, and drawers and dialogs keep focus inside until they close.
Animations (Theme settings > Animations): sections and product cards rise into view as customers scroll, images react to the pointer, and large banner images move gently with the page (Move large images gently on scroll). Every animation uses only transform and opacity, content already on screen is never hidden, and all motion stops for customers who ask their device to reduce motion.
Tips: use images around 2000px wide for full-width sections, keep the number of apps low, and add alt text to your images in Content > Files.
Frequently asked questions
How do I show different products in each tab of the featured collection?
Add one Collection block per tab and choose a collection in each. Use the Tab label field to rename a tab.
Why is the free shipping bar not showing?
Enter an amount in Theme settings > Cart > Free shipping threshold. The bar is hidden when the customer's currency differs from your store currency.
How do I add swatches?
Open a product's options in the admin and set a color or image for each value. Gemma Oro shows them on product pages, product cards and in filters.
Can I change the code?
Yes. Duplicate your theme before editing code, so you can always go back. Code changes are not covered by support; for custom work we suggest hiring a Shopify Partner.
Support policy
Live chat and support 24/7, every day of the week. The live chat on dartdesign.store and the support form answer around the clock; questions that need a person (refunds, complaints, custom work) are answered within two business days.
Support covers installing and setting up the theme, explaining its settings, and fixing bugs in the theme. It does not cover custom code changes, third-party apps or design services.
Updates are free. To update, add the new version from the Theme Store and move your settings with Shopify's theme update tool.
Release notes
Version 1.0.0
- First release.
- Fourteen ready-made color palettes on top of five editable color schemes.
- Two-row header with search field, tagline and bag; menu trays with link columns, metal and stone swatch links and menu images; sticky menu row.
- Slideshow with an image and a colored panel, numbered dots and a featured piece card.
- Oval collection list, pill tabs in the featured collection, material guide, story with collage, image banner with a text card, email signup beside its text.
- Jewel-box product cards with a material line, light sweep and swatches on the photo.
- Engraving field on the product page and swatches with names.
- Collection banner with oval collection shortcuts and quick filter buttons; filters with metal swatches.
- Product gallery with magnifier and a full-screen viewer; back in stock request, delivery estimate, purchase options, pre-order, volume pricing, combined listings.
- Press, before and after, countdown and quick order list sections; promotion pop-up, age verification, gift wrapping, extra contact form fields.
- Translations for seven languages and full right-to-left support.