# Overview

### What is a theme section?

Theme sections are the building blocks of your Shopify storefront. Each section represents a modular piece of content—such as a banner, product list, slideshow, or testimonials—that you can add, remove, or reorder to design your pages without coding.

Every section is built from **blocks**, which control the internal content and layout of that section (e.g., headings, images, buttons, icons, videos, and more).

In Pebble, sections are highly flexible, responsive, and optimized for both design and performance. 

{% hint style="success" %}
Explore a full list of available sections in the theme editor.
{% endhint %}

### **How sections work in the theme editor**

Inside the theme editor, you can:

* **Add a section** → Choose from Pebble’s full library
* **Reorder sections** → Drag and drop to adjust page structure
* **Customize settings** → Adjust layout, appearance, and content
* **Add blocks** inside a section → [Learn more about blocks](https://docs.foxecom.com/pebble-theme/theme-blocks)
* **Duplicate or remove sections** as needed.

Sections update in real time so you can preview your layout as you build.

### **Common settings available in most sections**

Although each section has its own unique features, many include a shared set of universal controls:

* [#container](#container "mention")
* [#color-scheme](#color-scheme "mention")
* [#border](#border "mention")
* [#padding](#padding "mention")

{% tabs %}
{% tab title="Container" %}
The **Container** setting controls how wide your content appears on the page.

Options:

* **Full** – Stretches the section across the full browser width.\
  \&#xNAN;*Best for banners, marquees, hero sections, and full-bleed visuals.*
* **Fixed** – Keeps content within the theme's standard page width.\
  \&#xNAN;*Best for text-heavy sections, product info, or content that needs consistent alignment with the rest of the page.*

Fixed width follows the **Theme settings** > [#page-width](https://docs.foxecom.com/pebble-theme/theme-settings/layout#page-width "mention").

{% tabs %}
{% tab title="Fullwidth" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FYhXFw2rdVbcamgREx9UI%2Fimage.png?alt=media&#x26;token=d4cfea24-13fd-40d1-ae7c-2116ef485a2c" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Fixed width" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FjmoBSzDUQ1jHB9bnmBiq%2Fimage.png?alt=media&#x26;token=dcfce9b6-16ab-4a6e-a536-1745f4ff225b" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="Color scheme" %}
Color schemes let you quickly control section background and text contrast.

* Applies predefined color combinations from your theme settings.
* Ensures accessible contrast and consistent branding across your storefront.

*Learn more:* [colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors "mention")

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F01IWlqpKigd7ncRxl4eq%2Fimage.png?alt=media&#x26;token=3274ba34-eabd-49c5-8de2-345fd79b802b" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Border" %}
The **Border** setting adds visual definition around a section.

Options:

* **None** – No border applied.
* **Solid** – A thin, solid border around the entire section.
* Additional controls:
  * **Border width**
  * **Border opacity**
    {% endtab %}

{% tab title="Padding" %}
Padding controls the spacing *inside* the section.

**Devices:**

You can set padding for:

* Desktop
* Mobile

**Padding controls:**

* Top
* Bottom
* Left
* Right

{% hint style="success" %}
Good padding ensures:

* Comfortable readability
* Proper breathing room around elements
* Visual consistency across sections
* Better mobile experience (reduce excessive top/bottom spacing).
  {% endhint %}
  {% endtab %}
  {% endtabs %}

### Explore Pebble sections

{% columns %}
{% column %}
{% content-ref url="hero-banner" %}
[hero-banner](https://docs.foxecom.com/pebble-theme/theme-sections/hero-banner)
{% endcontent-ref %}

{% content-ref url="collection-highlight" %}
[collection-highlight](https://docs.foxecom.com/pebble-theme/theme-sections/collection-highlight)
{% endcontent-ref %}

{% content-ref url="collection-list" %}
[collection-list](https://docs.foxecom.com/pebble-theme/theme-sections/collection-list)
{% endcontent-ref %}

{% content-ref url="collection-list-flex-carousel" %}
[collection-list-flex-carousel](https://docs.foxecom.com/pebble-theme/theme-sections/collection-list-flex-carousel)
{% endcontent-ref %}

{% content-ref url="collection-tabs" %}
[collection-tabs](https://docs.foxecom.com/pebble-theme/theme-sections/collection-tabs)
{% endcontent-ref %}

{% content-ref url="contact-form" %}
[contact-form](https://docs.foxecom.com/pebble-theme/theme-sections/contact-form)
{% endcontent-ref %}

{% content-ref url="custom-section" %}
[custom-section](https://docs.foxecom.com/pebble-theme/theme-sections/custom-section)
{% endcontent-ref %}

{% content-ref url="featured-collection" %}
[featured-collection](https://docs.foxecom.com/pebble-theme/theme-sections/featured-collection)
{% endcontent-ref %}

{% content-ref url="highlight-text-with-image" %}
[highlight-text-with-image](https://docs.foxecom.com/pebble-theme/theme-sections/highlight-text-with-image)
{% endcontent-ref %}

{% endcolumn %}

{% column %}
{% content-ref url="image-cards-flex-carousel" %}
[image-cards-flex-carousel](https://docs.foxecom.com/pebble-theme/theme-sections/image-cards-flex-carousel)
{% endcontent-ref %}

{% content-ref url="newsletter" %}
[newsletter](https://docs.foxecom.com/pebble-theme/theme-sections/newsletter)
{% endcontent-ref %}

{% content-ref url="products-bundle" %}
[products-bundle](https://docs.foxecom.com/pebble-theme/theme-sections/products-bundle)
{% endcontent-ref %}

{% content-ref url="products-highlight" %}
[products-highlight](https://docs.foxecom.com/pebble-theme/theme-sections/products-highlight)
{% endcontent-ref %}

{% content-ref url="product-suggestion" %}
[product-suggestion](https://docs.foxecom.com/pebble-theme/theme-sections/product-suggestion)
{% endcontent-ref %}

{% content-ref url="product-tabs" %}
[product-tabs](https://docs.foxecom.com/pebble-theme/theme-sections/product-tabs)
{% endcontent-ref %}

{% content-ref url="scrolling-cards" %}
[scrolling-cards](https://docs.foxecom.com/pebble-theme/theme-sections/scrolling-cards)
{% endcontent-ref %}

{% content-ref url="slideshow" %}
[slideshow](https://docs.foxecom.com/pebble-theme/theme-sections/slideshow)
{% endcontent-ref %}

{% content-ref url="store-locators" %}
[store-locators](https://docs.foxecom.com/pebble-theme/theme-sections/store-locators)
{% endcontent-ref %}

{% content-ref url="testimonials" %}
[testimonials](https://docs.foxecom.com/pebble-theme/theme-sections/testimonials)
{% endcontent-ref %}

{% endcolumn %}
{% endcolumns %}