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.
Theme Structure
Learn the file structure, required files, and organization patterns for Orbit Commerce themes.
Liquid Template Language
Master Liquid syntax, filters, tags, and objects to build dynamic storefronts.
Theme Sections
Create reusable, customizable sections with schema definitions and drag-and-drop support.
Quick Navigation
Jump to specific development topics.
Pre-Built Components
Ready-to-use UI components to accelerate your theme development.
Product Cards
Display products with images, pricing, and variants
Navigation Menus
Build responsive navigation with mega menus
Cart Drawer
Slide-out cart with live updates and mini preview
Search Components
Autocomplete search with filters and facets
Product Filters
Advanced filtering with price, color, size options
Image Galleries
Product image carousels with zoom and lightbox
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 StoreTheme Kit CLI
Download our command-line tool for local theme development and deployment.
Get Theme KitPartner Program
Build themes for clients or sell in our marketplace as a theme partner.
Become a PartnerReady 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.