Layout Builder Issues
Fix common problems with Layout Builder blocks, sections, and media uploads.
Having trouble with Layout Builder? Find solutions to common issues below.
Blocks Not Appearing
Problem: Added blocks don’t show up on the page.
Solutions:
Check Block Placement
- Ensure block is in a visible region
- Check block’s visibility settings
Clear Cache
drush crCheck Permissions
- Visit
/admin/people/permissions - Ensure role has “Create and edit custom blocks”
- Visit
Check Block Configuration
- Inline blocks must be configured before adding
- Some blocks require additional fields
Section Styling Not Working
Problem: Section background colors or styles don’t apply.
Solutions:
Clear Cache
drush crCheck Theme Compatibility
- Small Y template required for some styles
- Some styles only work with specific themes
Rebuild CSS
drush cron drush cr
Media Upload Failures
Error: The file could not be uploaded.
Solutions:
Check File Permissions
chmod -R 755 sites/default/files chown -R www-data:www-data sites/default/filesCheck File Size Limits
// In php.ini or .htaccess upload_max_filesize = 64M post_max_size = 64MCheck Disk Space
df -hCheck Allowed File Extensions
- Visit
/admin/config/media/file-system - Add extension if needed (e.g.,
.webp)
- Visit
Need more help? Browse the Block Library or Get Support.