Orbit Commerce
Theme Development

Components & Theme Documentation

Build beautiful, high-converting storefronts with Orbit Commerce. Complete theme development guide, component library, and customization APIs.

Core Concepts

Essential topics to master theme development on Orbit Commerce.

Quick Navigation

Jump to specific development topics.

Theme Sections

Reusable sections with customizable settings that users can drag and drop.

Hero Banner

hero.json

Full-width hero with CTA

Featured Collection

collection.json

Showcase product collections

Testimonials

testimonials.json

Customer reviews carousel

Newsletter

newsletter.json

Email signup form

Rich Text

rich-text.json

Flexible content blocks

Image Grid

image-grid.json

Multi-column image layouts

Section Schema Example

JSON
{
  "name": "Hero Banner",
  "class": "section-hero",
  "settings": [
    {
      "type": "image_picker",
      "id": "background_image",
      "label": "Background Image"
    },
    {
      "type": "text",
      "id": "heading",
      "label": "Heading",
      "default": "Welcome to our store"
    },
    {
      "type": "richtext",
      "id": "subheading",
      "label": "Subheading"
    },
    {
      "type": "url",
      "id": "cta_link",
      "label": "Button Link"
    }
  ],
  "presets": [{
    "name": "Hero Banner",
    "category": "Hero"
  }]
}

Liquid Objects

Available template objects and their properties for dynamic content rendering.

Store Objects

shop

Store name, email, currency, policies

cart

Cart items, total, item count

customer

Logged-in customer data

settings

Theme settings values

Product Objects

product

Product details, variants, images

collection

Collection products and metadata

variant

Product variant options and pricing

image

Product and collection images

Page Objects

page

Page content and metadata

blog

Blog posts and articles

article

Individual blog post

template

Current template name

Example: Product Card Component

A complete product card example using Liquid templating.

<!-- Product card component -->
<div class="product-card" data-product-id="{{ product.id }}">
  <!-- Product Image -->
  {% if product.featured_image %}
    <a href="{{ product.url }}" class="product-card__image">
      <img 
        src="{{ product.featured_image | img_url: '600x600' }}" 
        alt="{{ product.featured_image.alt | escape }}"
        loading="lazy"
      />
    </a>
  {% endif %}

  <!-- Product Info -->
  <div class="product-card__info">
    <h3 class="product-card__title">
      <a href="{{ product.url }}">{{ product.title }}</a>
    </h3>
    
    <!-- Price -->
    <div class="product-card__price">
      {% if product.compare_at_price > product.price %}
        <span class="price-sale">{{ product.price | money }}</span>
        <span class="price-compare">{{ product.compare_at_price | money }}</span>
      {% else %}
        <span class="price">{{ product.price | money }}</span>
      {% endif %}
    </div>

    <!-- Add to Cart -->
    <form action="/cart/add" method="post">
      <input type="hidden" name="id" value="{{ product.first_available_variant.id }}" />
      <button type="submit" class="btn btn-primary">
        Add to Cart
      </button>
    </form>
  </div>
</div>

Browse Themes

Explore our marketplace of professional themes to get inspiration or purchase.

Theme Store

Theme Kit CLI

Download our command-line tool for local theme development and deployment.

Get Theme Kit

Partner Program

Build themes for clients or sell in our marketplace as a theme partner.

Become a Partner
Start Building

Ready to build your first theme?

Follow our quick start guide to create a custom theme from scratch. We'll walk you through the entire process from setup to deployment.