Jump to HeaderJump to Main ContentJump to Footer
Michigan State University
Michigan State University
Digital Experience Studio

University Communications and Marketing

Digital Experience Studio

  • Experience Program
    • Website Project Process
    • Working with a Vendor
    • Glossary
    • Taxonomy Data Dictionary
  • |
  • Experience Design
    • Website Strategy
    • Website Structure
    • Information Architecture and Navigation
    • User-Centered Design Conventions
    • Common UX Issues
    • Enterprise Design System
    • Content Planning
    • Creating Accessible Content
    • Taxonomy and Filters
  • |
  • Website Technology
    • Web Standards
    • Search Engine Optimization
    • Cascade CMS
    • Sitecore CMS
    • Content Hub Overview
    • Content Hub DAM
    • Content Hub Operations

    SitecoreAI

    Sitecore user login
  • |
  • Social Media
    • Alt Text Bookmarklet
    • Meta Ad Pixel
    • Social Media and Web Integration
    • Sprinklr

    Sprinklr

    Sprinklr user login
  • |
  • Analytics
    • Google Analytics (GA4)
    • Testing
    • Data Visualization

    Google Analytics

    Google Analytics user login
  • |
  • News and Events
    • News and Updates
    • Events and Trainings
Digital Experience Studio

University Communications and Marketing

  • Experience Program
  • Experience Design
  • Website Technology
  • Social Media
  • Analytics
  • News and Events

< Experience Program

  • Website Project Process
  • Working with a Vendor
  • Glossary
  • Taxonomy Data Dictionary

< Experience Design

  • Website Strategy
  • Website Structure
  • Information Architecture and Navigation
  • User-Centered Design Conventions
  • Common UX Issues
  • Enterprise Design System
  • Content Planning
  • Creating Accessible Content
  • Taxonomy and Filters

< Website Technology

  • Web Standards
  • Search Engine Optimization
  • Cascade CMS
  • Sitecore CMS
  • Content Hub Overview
  • Content Hub DAM
  • Content Hub Operations

SitecoreAI

Sitecore user login

< Social Media

  • Alt Text Bookmarklet
  • Meta Ad Pixel
  • Social Media and Web Integration
  • Sprinklr

Sprinklr

Sprinklr user login

< Analytics

  • Google Analytics (GA4)
  • Testing
  • Data Visualization

Google Analytics

Google Analytics user login

< News and Events

  • News and Updates
  • Events and Trainings
Digital Experience Studio > Website Technology > Sitecore CMS > Sitecore Component Guide >

Accordion

MSU Tools and Resources

  • A to Z Index
  • Find People
  • Email
  • Tech Support
  • Social Media Directory

Communications Resources

  • University Communications and Marketing
  • University Trademarks and Licensing
  • MSU Brand Studio
  • MSU Editorial Style Guide
  • MSU Photos

Contact us

517-355-7505

Address

Michigan State University 408 West Circle Drive East Lansing, MI 48824

Follow Us

  • Visit our Facebook page
  • Visit our page on X
  • Visit our Instagram page
  • Visit our LinkedIn page
  • Visit our YouTube page
  • Visit our TikTok page

If you're having accessibility issues, please let us know.

Know MoreTransparency Reporting: Budget & Salary/Compensation
  • Contact Information|
  • Site Map|
  • Privacy Statement|
  • Site Accessibility|
  • Call MSU: (517) 355-1855|
  • Visit: msu.edu|
  • Notice of Nondiscrimination|

SPARTANS WILL|© Michigan State University|

Accordion

Headings, displayed vertically and stacked, that expand to reveal panels containing rich text content. Visitors can click the headings to show or hide a panel’s content.

accordion-sample
Figure 1: The initial display of the accordion has all panels in a collapsed state.
accordion-expanded-sample
Figure 2: Clicking a panel title expands the panel. Here, one of the panels has been expanded.

 

Component Information

  • Usage
  • Benefits

    • Organizes content in a compact space. Related content is organized and displayed in sections.
    • Efficiently presents content and minimizes page length and scrolling. This is especially helpful for mobile users.
    • Presents content in a way that allows visitors to read a list of headings, or topics, and then expand panels to view only the content for topics that are of interest.
    • Allows the content author to hide detailed content until the website visitor is ready to view it while providing a panel heading to indicate what content will be found within the panel.
    • Remains active for search engines to crawl even though the content is not always visible.

    Example Use Cases

    • Provide a list of headings as scannable topics so that visitors only open the headings for content they want to see.
    • Provide a menu of all topics. The visitor can quickly scan panel headings and locate specific topics of interest.
    • Provide a “big picture” to the visitor before they view all the details.
  • Best Practices
  • Template Data

    Accordion Tab Fields

    Panel Title (single-line text)

    • Heading for the panel. This displays even if the panel content is hidden.
    • Required field.

    Panel Content (Simple mode only)

    • Rich-text content used for the panel content in the “Rich Text Only” variant.

    “Placeholder Available” variant Accordion Tab Content

    • Panel content is created using component(s).
    • Eligible components include Image, Video Player, CTA Button, Rich Text, Table, Column Splitter and Row Splitter.
    • Template Data follows component documentation.  

    Frequently Asked Questions

    Can I open a specific panel when the page loads?

    No, this function is not supported using the Accordion.

    Instructions for Use

    A new “Rich Text Only” Accordion Tab variant was added to the system on June 9, 2026. By default, tabs will contain a rich text field. Selecting the “Placeholder Available” variant will enable users to add additional content components to the Accordion tab.

    Adding the Accordion Container

    Note: The Accordion container may only be added to the page in Page Builder. 

    If it is the first component in the placeholder:

    1. Click the Pages tab at the top of the left side panel to display the Sitemap
    2. Click to select the page in the Sitemap.
    3. Click “+” button in the mainbody or twothirdsbody placeholder box below the Breadcrumb links.
    4. Select Accordion component from list.

    If added to a placeholder that already has one or more components:

    1. Click the Pages tab at the top of the left side panel to display the Sitemap.
    2. Click to select and display the page in the Sitemap.
    3. Click the Components tab at top of the left side panel to display the Components menu.
    4. Locate Accordion component in the Container group. Drag the Accordion component to an allowed location above or below an existing component in the mainbody or twothirdsbody areas.

    The Accordion Tab and toolbar are displayed.

    Screenshot of an empty accordion component with the Accordion component toolbar displayed above it.
    Figure 3: The Accordion component has been placed on the page

    Image Specifications

    Sketch Link: Accordion Component Design

    Images in Tabs

    • Desktop – Width: 915px | Height: 665px
    • Mobile – Width: 275px | Height: 200px
    • Recommended size – Width: 1000px | Height: 700px

    Tool Use Guide

    *Add content type and then follow component-specific instructions

     

    Documentation updated: June 29, 2026

    Is there an issue with this documentation? Report it here.

    Component Options and Limitations

    • Use the “Rich Text Only” Accordion Tab variant to display basic panel content. This variant requires fewer system resources to edit and display.
    • It is not possible to load a page with a specific Accordion Tab opened.
    • Data is created for a specific type of component. Sitecore will not allow a data item to be assigned to another type of component. For example, a Data > Accordion item cannot be assigned to a Hero Banner component.

    Guidelines

    • Both Accordion Tab variants may contain rich text content that can be styled (e.g., bulleted lists, alignment, bold text) and include text links, images and other embedded HTML content. For additional component and layout options, use the “Placeholder Available” variant.
    • There is no limit on how much rich text is placed in an Accordion Tab. However, keep the user experience in mind, such as visitors viewing long content on a mobile device.
    • An Accordion is not suitable for content that should always remain viewable. Do not use an Accordion in these cases, as doing so would force visitors to click all the panels open.
    • Headings should be short and concise. They should accurately indicate what content will display when the panel expands.
    • An Accordion component can be used in the left column of a two-column page layout.
    • Do not nest Accordion, Side Tab or Tab components. Doing so creates a bad experience for users, particularly on mobile devices.
    • Test view an Accordion using multiple devices to verify that text displays properly. What looks good in desktop mode may not look good in mobile mode.
  • Tips and Tricks
    • An Accordion is an efficient way to display content. Even a single-panel Accordion is an effective way of providing content without initially displaying it on page load.
    • For text-only or simple content use the “Rich Text Only” variant.
    • Use the Column Splitter tool in the “Placeholder Available” variant to create a multicolumn format inside a panel.
    • Use the Row Splitter tool in the “Placeholder Available” variant to combine a multicolumn format and single-column format within one panel.
    • Interesting ways to use Accordion:
      • One-page staff directory — Use tab headings for names and panel content for profile information.
      • News list — Create a manually maintained list of news pages, linked to news story pages.
      • Procedures — Each tab contains a different subprocedure and its steps.
      • Meetings — Use tab headings for the meeting date and tab content for the meeting agenda or minutes.
      • Questions and answers — List questions in the tab headings and expand the tab to reveal the answer.
  • Expected Behavior
    • Tab headings can be clicked to expand and display tab content. Clicking a second time will close the tab.
    • Initial state: When the page loads, all tabs are closed and all tab content is hidden.
    • Open state: After clicking a tab heading, the tab opens and all tab content displays.
    • To expand (show) a tab, click the heading or the “+” on the right side of the tab. Click again to collapse (hide) the content.
    • Opening a tab does not close other open tabs. Multiple tabs may be open at the same time.
    • Accordion headings display in the order in which they appear in the component item list.
  • Related Information
  • Related Components

    • Tabs component — The Tabs component has similar functionality. Accordion heading and tabs display vertically. Tab headings and panels display horizontally. Opening a tab panel replaces the display of the previously opened tab panel.
    • Side Tabs component — The Side Tabs component has similar functionality. Accordion heading and tabs display vertically. Side Tab headings and tabs display vertically, too, but one always remains open and visible. Opening a side tab panel replaces the display of the previously opened side tab panel.

    Live Example

    • Demo: Information-Focused Content Components
    Can I add a thumbnail image or icon to the Accordion tab heading?

    No, images are not supported in the heading.

    Add Accordion Tabs to an Accordion Component

    In Page Builder:

    To add a first Accordion Tab:

    1. Click the purple “+” icon in the placeholder space and select Accordion Tab component from list.
    2. Map content to the tab following steps below.

    To add additional Accordion Tabs:

    1. Drag an Accordion Tab component to the Accordion container to add an additional tab to the Accordion. A dark purple line will display showing where the tab will be added.
    2. Map content to the tab following steps below.

    Mapping a new Accordion content data source:

    1. In the “Assign content item” dialog box, hover over Data until a “+” appears to the right.
    2. Click “+” and select "Tab Panel" (previously called “Accordion Tab” or “Accordion with Panel”).
    3. Give the component a unique name and click away from the name area on hit the Enter key.
    4. Click Assign.

    Mapping an existing Accordion content data source:

    1. Select the proper Accordion Tab component from the list.
    2. Click Assign.

    To change mapping to a different content data source:

    1. Click on the Accordion Tab to select it. The tab will be outlined with a thick purple line and a toolbar with the panel name will appear.
    2. Click the Swap with another component icon on the toolbar.
    3. Choose Accordion Tab from the menu.
    4. Select the replacement tab from the data sources available and click Assign.

     

    Initially, an Accordion panel appears as the "Rich Text Only" variant, without a title or text. Enter text in both fields, or adjust the variant.

    Screenshot showing what the Accordion component looks like when initially placed on the page. The title field reads
    Figure 4: The initial appearance of an Accordion tab shows placeholder text for an empty title field and a button to add content.

     

    To change the variant of a tab:

    The default variant for a new tab is is the “Rich Text Only” variant which uses the Panel Content (Simple mode only) field to contain rich text.

    To add alternative content types to the tab, change this tab variant to the Placeholder Available variant:

    1. Click on the Accordion Tab to select it. The tab will be outlined with a thick purple line and a toolbar with the panel name will appear.
    2. Click the Design Tab in the right side panel.
    3. Choose Placeholder Available from the top field variant menu.
    4. The tab will now display a “+” icon that can be clicked to assign a component.

    To move Accordion Tabs:

    1. Click on the Accordion Tab to select it. The tab will be outlined with a thick purple line and a toolbar with the panel name will appear. (Note: It may say “Side Tab Panel.”)
    2. Click and hold on the 10-dot handle icon on the component toolbar and move the Accordion Tab to the desired location in the Accordion container. 

    Instructions for previous iteration of Accordion:

    In Page Builder:

    1. Click the Accordion component to display the toolbar.
    2. In “Accordion” right column, expand Manage items.
    3. Change Item 1, which is automatically created, as needed:
      1. Rename — Click “…” to right of Item and give it a new name.
      2. Delete item — Click “…” to right of item and delete it.
    4. Add more panels as needed:
      1. Click “+ Add new” and click Accordion Tab button.
      2. Give it a unique name.
    5. To rename a panel: Click “…” to right of the item and give it a new name.
    6. To delete a panel: Click “…” to the right of the item and delete it.
    7. To reorder panels: Click “…” and use the up and down arrows to change the tab order.
    Add Content to Accordion Panels

    In Page Builder:

    1. In the middle pane, or content pane, add an Accordion tab title by typing in the rich text field. The title is the panel Heading. Initially, title is set to “[No text in field].”
    2. In the panel content area below the title, click the blue “+” and select a type of content to add.
    3. Select any permitted component from the dialog box. Permitted components include:
      1. Image
      2. Video Player
      3. Column Splitter
      4. Row Splitter
      5. CTA Button
      6. Rich Text
      7. Table

    Alternate method: Click Components tab at the top of the content tree. Drag a component into the Accordion panel placeholder box.

    To assign a new component data source to an Accordion component:

    1. Click “+” to the right of the Accordion Tab to nest the accordion content underneath the parent Accordion container. Content may also be added to the main Data level.
    2. Give the data source a unique name.
      1. Tip: Include the panel name to more easily match this data source to the correct panel.
    3. Click Assign.

    To assign an existing data source to an Accordion component:

    1. Select the data item.
    2. Click Assign.

    Repeat as necessary to add all panels to the Accordion and to add content to all panels. Follow the instructions for specific components being added to panels.

    Note for images: For regular desktop devices (1280px width), the panel image width is 1046px and the image displays by default with a width of 800px. The image’s aspect ratio determines the height. Use Content Editor to change image size using the image Properties link. Image alt text can be edited using the Alt Text field in Content Editor but not Page Builder.
    Alternative: Edit Using Content Editor

    Note: Only Accordion Tab components have a data element in Content Editor, the Accordion container does not appear there.

    Locate the Accordion Tab

    1. Open Content Editor:
      1. In Page Builder, click the dropdown arrow to the right of the SitecoreAI icon in upper left..
      2. Select Content Editor. It opens in a new browser tab.
    2. If the Accordion Tab does not appear in the Content Tree, close the page’s Data node and expand it again to refresh the Content Tree.
    3. In the Content Tree, expand Content > MSU > site name > Home > page name > Data.
    4. Locate and select the Accordion Tab component.

    Edit an Accordion Tab

    To edit an existing Accordion Tab’s Panel Title or Panel Content field:

    1. Click the tab in the Content Tree.
    2. Click on Edit or Lock and Edit to lock tab for editing.
    3. Change as needed in the main content pane on the right side.
    4. Save edits.

    To edit existing components in an Accordion Tab:

    1. Locate the existing component in the Content Tree
    2. Expand an Accordion Tab data if component data is nested under it.
    3. Edit component data following standard component procedure.
    4. Save edits.

    To create a new content type in an Accordion Tab:

    1. Right-click the tab.
    2. Select Insert and select a content type (column and row splitters need to be added in Page Builder).
    3. Add content in the main content pane on the right side.

    Tips for Using Images

    • Alt Text should be added to images and saved in the media library folder, but can be overridden in Page Builder in the image’s “Image alt text” field or the “Alternate Text” field in Image > Properties in Content Editor.
    • An image size can be changed in Content Editor > Image > Properties. HTML uses width and height attributes.
    • The image margin (i.e., padding) can be changed in Content Editor > Image > Properties.
    • For regular desktop devices (1280px width), the panel image width is 1046px and the image displays by default with a width of 800px.
    • The image’s aspect ratio determines the height.

    Delete an Accordion Tab

    Note: To avoid potential issues on the page, remove the accordion tab from the page in Page Builder before delete its data in Content Editor.
    1. Locate and expand the Accordion Tab component.
    2. In the Content Tree, right-click the tab.
    3. Click Delete and confirm.

    Publish Changes

    When done with content authoring activities:

    1. Return to Page Builder.
    2. Click the Reload canvas icon to see changes.
    3. Preview and submit the page to the publishing workflow.
    A Note Regarding "Accordion (OLD)" Components

    The Accordion component was rebuilt in fall 2024 resulting in some changes in how they are constructed. Any accordions built before this change will display "Accordion (OLD)" when hovered on in Page Builder and will still work using the instructions for the previous version (see "Add Accordion Tabs to an Accordion Component," below).

    Note: removing or adding tabs to an Accordion (OLD) component may cause issues with the mapped content. Users may need to re-map content to the appropriate accordion tab. Users may wish to rebuild an Accordion (OLD) component into a new Accordion component to prevent this issue in the future.