Documentation Images & Media Library

05 / Content photography

Images & Media Library

Replace images with native WordPress controls and understand the shared photo parts.

For Purlia 1.0.13 min readUpdated 4 Nov 2026

Replace a page image

  1. Open the page in the block editor. For Home 1, open the Front Page template in the Site Editor.
  2. Select the Image block. If text overlaps it, select it from List View.
  3. Use the block’s Media or Replace control and choose an existing Media item or upload a new photo.
  4. Write useful alternative text, or mark a purely decorative image as decorative.
  5. Preview the crop and mobile layout, then save. An image used in several blocks is not automatically replaced in every block when you choose a different attachment here.
Purlia Image block selected in the page editor, with a Media attachment shown in the sidebar
A selected Home 2 photo shows its Media attachment in the editor sidebar. Select the image to view it at full size.

Know which image to edit

PhotoWhere it is controlled
Home 1 hero/category/making imagesFront Page template → its Image blocks
Home 2–4 and editorial page photosThe page’s Image blocks
Shop mega menu photoTemplate Part → Shop feature image
Login, registration and password recovery photoTemplate Part → Account welcome image
Account dashboard feature photoTemplate Part → Account dashboard image
Product cover and galleryThe WooCommerce product’s image/gallery settings
Journal card/article featured imageThe post’s Featured Image
Empty-state artworkThe relevant Cart, Mini Cart, Search or 404 template/pattern Image block

To edit a shared photo, open Appearance → Editor → Patterns → Template Parts, choose its named part, select the Image block and choose Media. The theme does not require editing a PHP image URL.

Shop feature image opened as an editable template part in the WordPress Site Editor
The Shop photo is a separate template part, so it can be changed independently of Navigation. Select the image to view it at full size.

Prepare useful images

UseSuggested starting sizeComposition
Wide hero or editorial photoAround 1600 × 1000 pxKeep important subjects away from crop edges.
Product cover/galleryAround 1200 × 1200 pxUse consistent framing for catalog cards.
Category cardAround 1000 × 1000 pxAllow room for a landscape crop.
LogoA clean, high-quality sourceCheck small-screen legibility and background contrast.

These are starting points, not upload requirements. Compress photographs before uploading. Use JPEG, PNG or a format supported by your WordPress installation. Purlia uses attachment metadata for responsive sizes; available optimized WebP sidecars may be used for marked demo images. SVG uploads are not enabled by the theme.

If an image is missing or looks cropped

  • Confirm the attachment exists in Media and its original file is accessible.
  • Re-select the image if content was imported without its attachment or its image ID was not repaired.
  • Review the Image block’s aspect ratio/scale controls, then preview the actual page: Purlia uses cover crops in some layout areas.
  • Use a composition with more breathing room if the crop cuts off the subject.
  • After migrating from an older demo, follow the Media migration workflow instead of restoring hardcoded theme-file URLs.
Your store guide