# Card layered
The **Card layered** block combines an image with text content in a customizable card layout. Use it to highlight **featured products, collections, promotions, brand messages, key selling points**, or other content that pairs visuals with supporting text.
The block includes built-in **Subheading, Heading, and Text** blocks to organize your message. You can customize images for desktop and mobile, adjust the content alignment, and style the card to match your store's design.
## Settings
### Image
Controls the images displayed in the card on desktop and mobile devices.
| Setting | Description | Options |
| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Image** | Sets the image displayed on desktop. | Select or upload an image. |
| **Image mobile** | Sets a separate image for mobile devices. | Select or upload an image.
*If left empty, the desktop Image is used on mobile.* |
| **Aspect ratio** | Controls the image proportions on desktop. | **Auto:** Uses the image’s original proportions.
**Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)** |
| **Aspect ratio mobile** | Controls the image proportions on mobile devices. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)** |
| **Media overlay** | Controls whether a color overlay appears over the image. | **On** or **Off.** |
| **Overlay color** | Sets the color of the image overlay. | Select a color.
*Available when **Media overlay** is turned on.* |
### Content
Controls the spacing and alignment of the card content.
| Setting | Description | Options |
| ------------- | ------------------------------------------------------ | ------------------------------------- |
| **Padding** | Controls the space inside the card around its content. | **None, Small, Medium,** or **Large** |
| **Alignment** | Controls the horizontal alignment of the content. | **Left, Center,** or **Right** |
### Size
Controls how much horizontal space the card occupies on desktop and mobile.
| Setting | Description | Options |
| ----------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Width** | Controls the card width on desktop. | **Fit:** Keeps the card sized to its content.
**Fill:** Expands the card to fill the available width.
**Custom:** Lets you set a custom width. |
| **Custom width** | Sets the card width as a percentage on desktop. | **0–100%**
*Available when **Width** is set to **Custom**.* |
| **Width mobile** | Controls the card width on mobile devices. | **Fit, Fill,** or **Custom** |
| **Custom width mobile** | Sets the card width as a percentage on mobile devices. | **0–100%**
*Available when **Width mobile** is set to **Custom**.* |
### Appearance
Controls the card's color scheme, border, and corner styling.
| Setting | Description | Options |
| ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------------- |
| **Color scheme** | Sets the color scheme used by the card. | Select a theme color scheme. |
| **Border** | Controls whether the card has an outer border. | **None** or **Solid** |
| **Border width** | Controls the thickness of the card border. | **0–10px**
*Available when **Border** is set to **Solid**.* |
| **Border opacity** | Controls how solid or transparent the border appears. | **0–100%**
*Available when **Border** is set to **Solid**.* |
| **Corner radius** | Controls how rounded the card corners are. | **0–32px** |
## Card layered – items
The **Card layered** block includes three built-in static text blocks: **Subheading, Heading, and Text**. Each serves a different purpose within the card:
* **Subheading:** Displays a short introductory line above the main heading.
* **Heading:** Displays the main title or message of the card.
* **Text:** Displays supporting information or a short description.
These blocks are part of the card's built-in structure and cannot be removed or reordered.
### Subheading, Heading, and Text
All three blocks share the same settings for rich-text formatting, text highlighting, typography, padding, and animation, similar to the standalone **Text** block.
However, they have fewer customization options and do not include **Layout**, **Left/Right padding**, **Gradient text color**, or **Disable line break on mobile** settings.
For all other settings, including rich-text formatting, highlight styles, typography, padding, and animations, see the [**Text block documentation**](https://docs.foxecom.com/pebble-theme/theme-blocks/text).
## Tips and best practices
* Use separate **Image mobile** and **Aspect ratio mobile** settings when the desktop image doesn't display well on smaller screens.
* Apply **Media overlay** to improve text readability when the image background is too busy or bright.
* Keep the **Heading** short and use the **Text** block for supporting details to avoid overcrowding the card.