> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/get-started/key-concepts.md).

# Key concepts

Understand the core concepts behind Arctos: how Theme settings, Sections, Blocks, Layout containers, and Page templates work together.

Arctos is built as a flexible storytelling framework. Rather than restricting you to rigid, locked page layouts, Arctos gives you a hierarchy of modular components that connect together predictably. Understanding this mental model helps you build any layout faster and avoid common setup pitfalls.

### 1. Theme architecture at a glance

An Arctos storefront is organized into four levels, from store-wide defaults down to individual content elements:

<table><thead><tr><th width="180">Level</th><th width="200">What it is</th><th>Role in your store</th></tr></thead><tbody><tr><td><strong>Theme settings</strong></td><td>Global design system</td><td>Defines store-wide defaults: typography scales, color schemes, main corner radius, container widths, and global component styles (buttons, product cards, cart, search).</td></tr><tr><td><strong>Page templates</strong></td><td>Full page blueprints</td><td>Defines the page-level structure for each page type (Product, Collection, Blog, Cart, 404). Assigns which sections load on that page.</td></tr><tr><td><strong>Sections</strong></td><td>Structural frames</td><td>Provides the structural boundaries on a page (container width, height, background color/media, padding, and layout direction).</td></tr><tr><td><strong>Blocks</strong></td><td>Modular content units</td><td>The actual content elements inside a section (headings, text, buttons, images, product lists, or nestable layout containers like Group).</td></tr></tbody></table>

### 2. The four core concepts

#### 2.1. Theme settings: Global design system

Accessed via **Customize > Theme settings** in the bottom left sidebar. Theme settings establish your brand's foundation across the entire store:

* **Typography:** Store-wide font families, heading scales (H1–H6), paragraph, and label presets.
* **Colors:** Global color schemes, text color hierarchy (Strong, Base, Light, Subtle), and accents.
* **General:** Main corner radius (from which Small and Extra small radii automatically scale) and default container widths (Standard, Wide, Narrow).
* **Components:** Global styling rules for buttons, inputs, product cards, variant pickers, cart drawers, and customer accounts.

When you configure Theme settings properly first, every section and block you add later looks cohesive automatically.

#### 2.2. Sections: The structural frame

A section is the outer container spanning your page. Arctos includes two main types of sections:

* **Custom Section:** An empty, flexible canvas where you choose the width, height, background treatment (solid, gradient, image, or video with parallax), and padding, then drop in any blocks you want.
* **Pre-built Section Templates:** Specialized sections configured with pre-arranged blocks for common use cases (such as Featured collection, Featured products slideshow, Shop the look: Split layout, Header, and Announcement bar).

#### 2.3. Blocks: Modular content units

Blocks are the individual pieces of content living inside sections. They are independent and modular:

* You can add, reorder, restyle, or delete blocks without disturbing neighboring content.
* Each block has its own dedicated settings panel for typography, alignment, size, and spacing.
* Arctos offers over 30 block types across Basic, Collections and products, Contact, Media, Layout, Links, and Storytelling categories.

#### 2.4. Layout blocks: Structural containers

Layout blocks (such as **Group**, **Custom list**, and **Custom tab**) are a special category of blocks that display no content themselves. Instead, they act as containers to organize and group child blocks.

* A **Group** lets you arrange multiple blocks side-by-side (row) or stacked (column), apply a background card or border, and set unified gaps.
* Layout blocks can nest inside other layout blocks, giving you limitless layout freedom without custom code.

{% hint style="info" %}
**Troubleshooting tip:** Because layout blocks control the positioning, alignment, and maximum width of their child elements, if a block looks misaligned or unexpectedly narrow, always inspect its parent Group or Layout container first.
{% endhint %}

### 3. The style inheritance chain

Styles in Arctos follow a cascading inheritance chain:

```
Theme settings (Global defaults)
       └── Section (Frame defaults: color scheme, container width)
              └── Parent Layout Block (Group / Custom list container styles)
                     └── Child Block (Individual styling & overrides)
```

At each level, Arctos gives you explicit control:

* **Inherit color scheme:** On by default. A block or layout container adopts its parent's color scheme. Toggling this off lets you assign an independent color scheme to create visual contrast.
* **Main corner radius:** Shapes (Sharp, Rounded, Pill) and corner radius presets (Small, Extra small) automatically derive their proportions from the store-wide **Main corner radius** setting in Theme settings.
* **Product card settings:** Collection grids and product lists automatically inherit card settings from **Theme settings > Product card**, but offer a **Custom product card** toggle when a specific section requires unique card behavior.

### 4. Independent mobile controls

Arctos is built mobile-first. Every critical layout, typography, sizing, and spacing setting includes an independent **Custom on mobile** option:

* **Layout adjustments:** Switch direction (from horizontal row on desktop to vertical stack on mobile), change alignment, or tighten gaps.
* **Typography:** Scale down heading presets or specify dedicated font sizes and line heights for smaller screens.
* **Spacing:** Adjust padding and margins separately for desktop and mobile so content never feels cramped on phones or sparse on large monitors.
* **Media asset swapping:** Where relevant, supply dedicated mobile images or videos tailored for vertical phone viewports.

### 5. Recommended build workflow

When creating pages or sections from scratch, following this sequence produces the cleanest results:

{% stepper %}
{% step %}
**Establish Theme settings first**

Set up your store colors, typography presets, main corner radius, and container widths in **Customize > Theme settings**. This ensures consistent styling across all components.
{% endstep %}

{% step %}
**Add a Section**

Add a **Section** to your page. Set its container width, height, and background styling to frame the content.
{% endstep %}

{% step %}
**Place Layout containers first**

Before adding text or buttons directly, decide on the layout structure. Add a **Group**, **Custom list**, or **Custom tab** container to define columns and rows.
{% endstep %}

{% step %}
**Add content blocks inside containers**

Place your anchor blocks (such as Image, Heading, Text, or Button) inside the layout containers and arrange them by priority.
{% endstep %}

{% step %}
**Refine styling and check mobile preview**

Tune block typography and spacing, then switch to the **Mobile** viewport in the Theme Editor to adjust any **Custom on mobile** settings needed for a flawless mobile experience.
{% endstep %}
{% endstepper %}

### Related documentation

* [**Introduction to Blocks**](https://ursus-ecom.gitbook.io/arctos-theme/blocks/introduction-to-blocks.md) - how blocks work and best practices for building layouts
* [**Section**](https://ursus-ecom.gitbook.io/arctos-theme/section-templates/section.md) - customizing section containers and layout options
* [**Theme settings > General**](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/general.md) - configuring global container widths and corner radius
* [**Theme settings > Typography**](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/typography.md) - setting up store-wide typography presets
