Skip to Content

LogoCloudSection

Display accessible customer, partner, and integration logos in responsive grids, groups, or carousels.

LogoCloudSection presents consumer-provided logo collections. Each item must have a stable ID, name, and alt text, and must provide either an image src or a custom logo node.

Beta API maturity: Beta.

Installation

import { LogoCloudSection, type LogoCloudItem } from "@puzzle-ui/pieces";

Variant previews

The marquee is scrollable and intentionally motion-free. The carousel includes labeled controls and supports left/right arrow keys when its navigation group is focused.

grid - A balanced collection of partner or customer logos.

390 × 844

centered - A small logo set below a centered trust message.

390 × 844

monochrome - A unified visual treatment for mixed brand assets.

390 × 844

colored - Brand marks shown in their original colors.

390 × 844

carousel - A navigable collection when space is limited.

390 × 844

marquee - A horizontally scrollable row that stays motion-free.

390 × 844

featured - A set with one or more visually important partners.

390 × 844

grouped - Logos organized under consumer-provided categories.

390 × 844

compact - A denser logo collection for smaller page sections.

390 × 844

split - A trust message beside the logo collection.

390 × 844

bordered - A collection where separate logo tiles aid scanning.

390 × 844

dark - Logos placed on a contrasting dark surface.

390 × 844

API

PropTypeDescription
variantLogoCloudVariantSelects one of the twelve logo compositions; defaults to grid.
logosreadonly LogoCloudItem[]Logo data. LogoCloudItem requires id, name, and alt, plus either src or logo.
groupstring on each itemGroups logos when variant="grouped".
featuredboolean on each itemEmphasizes an item in the featured layout.
hrefstring on each itemOptional destination for a logo.
Shared section propsSectionRootProps and heading propsSemantic root, theme, native attributes, heading, actions, and children.

Usage

<LogoCloudSection
  variant="grouped"
  title="Our partners"
  logos={[
    {
      id: "acme",
      name: "Acme",
      alt: "Acme logo",
      src: "/logos/acme.svg",
      group: "Technology",
      href: "/partners/acme",
    },
  ]}
/>

Custom logo nodes are wrapped in an image role using the supplied alt text. Image sources are lazy-loaded. Empty collections render no list; the optional heading remains available.

Accessibility

Provide an accurate alt for every logo. A linked logo uses the supplied name as its link name. The carousel has named previous/next buttons and an arrow-key-operable group. No carousel or marquee autoplay is enabled.