> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Accordions

> Organize content into expandable and collapsible topics for FAQs, policies, and product details.

The Accordions section organizes content into expandable and collapsible topics. It is ideal for FAQs, product details, policies, or any content that benefits from progressive disclosure.

Accordions help reduce visual clutter and improve page scannability by allowing users to selectively reveal only the information they need, creating cleaner and more manageable content layouts.

<img src="https://mintcdn.com/digifist/Ly9MQA1EFygZ4iNf/images/theme/release/sections/accordions/accordions-overview.png?fit=max&auto=format&n=Ly9MQA1EFygZ4iNf&q=85&s=7080da489b2dba190fd5c6ff2a6891bc" alt="Accordions section overview" width="3280" height="2186" data-path="images/theme/release/sections/accordions/accordions-overview.png" />

## What this section controls

This section controls accordion-based content displays with the following capabilities:

* Expandable and collapsible content topics
* Individual topic expand/collapse functionality
* Default expanded state configuration
* Rich text or dynamic page content support
* Progressive disclosure for long-form content
* Clean, organized information architecture

## How the Accordions section works

The Accordions section uses a block-based topic system:

* Displays content in expandable accordion items
* Each topic can be opened or collapsed independently
* Content can be shown by default on page load
* Supports rich text or dynamic page content
* Helps reduce visual clutter on long pages

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Add Accordions section">
    Add the Accordions section to your page or template.
  </Step>

  <Step title="Add topics">
    Click **Add Topic** to create accordion items.
  </Step>

  <Step title="Configure content">
    Add heading and text content or connect to a page.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/Ly9MQA1EFygZ4iNf/images/theme/release/sections/accordions/accordions-location.png?fit=max&auto=format&n=Ly9MQA1EFygZ4iNf&q=85&s=111a3d37084a5e1b2754aa68f4c964e2" alt="Accordions section in Theme Customizer" width="3280" height="2186" data-path="images/theme/release/sections/accordions/accordions-location.png" />

## Section settings

Section settings control the main heading of the accordion group.

<Tabs>
  <Tab title="Heading">
    ### Heading

    Main title displayed above the accordion list.

    * Rich text supported (bold, italic, underline, links)

    ### Heading size

    Controls the size of the section heading.

    **Available options:** XS, S, M, L, XL

    <img src="https://mintcdn.com/digifist/Ly9MQA1EFygZ4iNf/images/theme/release/sections/accordions/heading-settings.png?fit=max&auto=format&n=Ly9MQA1EFygZ4iNf&q=85&s=5361e1c018df8b36668d7159da79c872" alt="Heading configuration" width="3280" height="2186" data-path="images/theme/release/sections/accordions/heading-settings.png" />
  </Tab>
</Tabs>

## Topic blocks

Topic blocks control individual accordion items. Each block represents a single accordion topic.

<Tabs>
  <Tab title="Topic settings">
    ### Show content on page load

    Controls whether the accordion content is visible when the page loads.

    * **True:** Content is expanded by default
    * **False:** Content is hidden until the user clicks the heading

    <img src="https://mintcdn.com/digifist/Ly9MQA1EFygZ4iNf/images/theme/release/sections/accordions/show-on-load.png?fit=max&auto=format&n=Ly9MQA1EFygZ4iNf&q=85&s=7acc1eef2c37f7e8bc919a1d5a15b230" alt="Show content on page load setting" width="3280" height="2186" data-path="images/theme/release/sections/accordions/show-on-load.png" />

    ### Heading

    Title of the accordion topic.

    * Text input

    ### Text

    Main content displayed when the topic is expanded.

    * Rich text supported

    ### Page

    Outputs the content of a selected Shopify page as the accordion body.

    * Shopify page selector

    <Warning>
      Overwrites the Text field when selected.
    </Warning>

    <Tip>
      Use this option to manage large or reusable content from a single page.
    </Tip>

    <img src="https://mintcdn.com/digifist/yuggJPUIy_CDeMJf/images/theme/release/sections/accordions/topic-content.png?fit=max&auto=format&n=yuggJPUIy_CDeMJf&q=85&s=ced9ffd8cb1ff6ba11f0e48815e0601d" alt="Topic content configuration" width="3280" height="2186" data-path="images/theme/release/sections/accordions/topic-content.png" />
  </Tab>
</Tabs>

## Best practices

* Keep headings concise and descriptive (5-8 words maximum) for quick scanning
* Avoid opening too many topics by default to maintain clean initial page state
* Use Page content for long or frequently updated information to simplify management
* Group related topics together logically for better user experience
* Ideal for FAQs, size guides, and policy sections where users seek specific information
* Test accordion interactions on mobile to ensure smooth expand/collapse
* Consider using first topic as expanded by default to demonstrate functionality
* Order topics by importance or frequency of access
* Use consistent formatting within accordion content for professional appearance

## Common use cases

* **Frequently asked questions (FAQ)** - Answer common customer questions in organized format
* **Shipping and return policies** - Display policy details without overwhelming the page
* **Product specifications** - Show detailed technical information progressively
* **Store information** - Share operational details like hours, locations, contact methods
* **Legal or informational content** - Present terms, privacy policies, or guidelines

## Related guides

<Card title="Common Settings" icon="sliders" href="/themes/release/common-settings">
  Learn about common settings shared across sections
</Card>
