Cover block extensions

Mobile Cover

Add a Cover Block

Search for “Cover” in the block inserter and add it to your page.

Set Desktop Background Image

Important: You must set a desktop background image first. The mobile image works as an alternative to the desktop image, not a replacement.

Upload Mobile Cover Image

With the Cover block selected, find the “Mobile Cover Image” panel in the right sidebar:

  • Click “Upload” or “Select from Media Library”
  • Choose your mobile-optimized image
  • The image will display on screens 781px or narrower

Adjust Mobile Settings

Once your mobile image is uploaded, additional controls appear in the Mobile Cover Image panel:

Mobile Settings Explained

Mobile Focal Point

Control which part of your mobile image stays visible when the cover is resized:

  • Click anywhere on the image preview
  • Drag the focal point to adjust positioning
  • Independent from desktop focal point (can be different)

Focal Point Best Practices

Portraits: Focus on the face (upper center)
Text overlays: Focus on the area where text appears
Landscapes: Center the focal point (default 50% 50%)

Mobile Width

Control the maximum width of the cover block on mobile devices:

  • Leave empty for 100% width (default)
  • Enter a value like “400px” for a fixed width
  • Use percentages like “90%” for relative width

Mobile Height

Set the height of the cover block on mobile devices:

  • Leave empty to use image’s height
  • Enter “300px” for a fixed height
  • Use viewport units like “50vh” (50% of viewport height)

Image Alignment (Horizontal)

Control how content inside the cover aligns horizontally on mobile:

  • Left – Align image to the left edge
  • Center – Align image to center (default)
  • Right – Align image to the right edge

Previewing Mobile Changes

See your mobile image and settings in real-time while editing:

  • Click the Cover block to select it
  • Click the Mobile icon in the WordPress editor toolbar (top-right)
  • The preview switches to mobile image automatically
  • Adjust settings and see changes instantly

Mobile Breakpoint

The extension uses WordPress’s standard responsive breakpoint:

  • Mobile – Screens 781px or less (mobile image displays)
  • Desktop – Screens 782px or more (desktop image displays)

This matches the WordPress admin bar breakpoint for consistency.

Examples

Hero Section with Portrait & Landscape

1. Add Cover block → Upload landscape desktop image (1920x600px)
2. Upload vertical mobile image (800x1200px)
3. Desktop focal point: Center (50% 50%)
4. Mobile focal point: Upper center (subject's face)
5. Result: Optimized images for both orientations

Short Mobile Cover with Full-Width Desktop

1. Desktop image: Full-width banner (100vh height)
2. Mobile image: Compact banner (400px height)
3. Set Mobile Height: "400px"
4. Set Content Alignment: "Center"
5. Result: Tall desktop cover, compact mobile cover

Centered Content on Mobile

1. Desktop: Cover with left-aligned content
2. Upload mobile image
3. Set Mobile Width: "90%" (some margins on sides)
4. Set Content Alignment: "Center"
5. Result: Centered content layout on mobile only

Tips & Best Practices

  • Image orientation – Use portrait/vertical images for mobile, landscape for desktop
  • Focal points – Set different focal points for desktop vs mobile based on composition
  • Height control – Use viewport units (vh) for proportional mobile heights
  • Always set desktop image first – Mobile image is an alternative, not a replacement

Quick Troubleshooting

Mobile image not showing on frontend?
→ Make sure you have a desktop background image set
→ Check that the mobile image URL is saved in block attributes

Can’t see Mobile Cover Image panel?
→ Make sure a Cover block is selected
→ The panel appears in the right sidebar (Inspector Controls)

Wrong image showing on mobile?
→ Check your screen size – breakpoint is ≤781px
→ Preview at mobile width (≤781px) to see the mobile image

Focal point not working?
→ The mobile focal point only applies on mobile viewports (≤781px)
→ Switch to mobile preview to see mobile focal point in action
→ Desktop view uses the desktop focal point

Mobile height not applying?
→ Check that a value is entered (e.g., “400px” or “50vh”)
→ Mobile height only applies at the 781px breakpoint
→ Leave empty to use desktop height settings


Comments

Leave a Reply

Your email address will not be published. Required fields are marked *