Use the Post Featured Image block to display the featured image of a post. This block is primarily nested inside a query loop block and helps to customize the appearance of the query loop.
To add a Post Featured Image block:
- Click the Block Inserter icon when editing the page template.
- Search for the Post Featured Image block.
- Click on it to add the block to your Post Template.
![GIF showing how to add Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image1-1024x580.gif)
You can also type /post-featured-image and hit enter in a new paragraph block to add the Post Featured Image block quickly.
Detailed instructions on adding blocks
![Featured image block placeholder](https://wordpress.org/documentation/files/2023/12/featured-image-block-placeholder-1024x488.png)
Block toolbar
To view the block toolbar, click on the block and the toolbar will be displayed.
Every block comes with unique toolbar icons. These block-specific controls allow you to manipulate the block right in the editor.
The Post Featured Image block shows six buttons in the block toolbar:
- Transform to
- Drag icon
- Move handles
- Apply duotone filter
- Change alignment
- More options
![Post Featured Image block toolbar](https://wordpress.org/documentation/files/2023/12/image3.png)
Transform to:
![Transform options for the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image9.png)
Click on the “Transform” button to convert the Post Featured Image block into a “Group” block or “Columns” block.
Drag icon:
![Drag icon in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image5.png)
To drag and drop the block to a new location on the page template, click and hold the rectangle of dots, then drag to the new location. The blue separator line indicates where the block will be placed. Release the left mouse button when you find the new location to place the block.
Move arrows:
![Move arrows in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image2.png)
The up and down arrow icons can be used to move the block up and down on the page.
Get more information about moving a block within the editor.
Change alignment:
- None – Leaves the block the current size.
- Wide width – Increase the width of the block beyond the content size.
- Full width – Extend the block to cover the full width of the screen.
- Align left – Make the block left-aligned.
- Align center – Make the block center aligned.
- Align right – Make the block right aligned.
Apply duotone filter
You can create a two-tone color effect (called the duotone effect) on the featured image without actually changing the original image. The duotone effect works best on high-contrast images.
You can pick the two colors for the effect from the list of six duotone presets provided in the drop-down.
- Foreground and background
- Foreground and secondary
- Foreground and tertiary
- Primary and background
- Primary and secondary
- Primary and tertiary
These are based on the foreground, background, primary, secondary and tertiary colors set in the theme’s color palette.
![Apply duotone filter in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image10.png)
You can also pick your own colors for the shadows and highlights by clicking on the Shadows /Highlights option which opens up the color picker and selecting your custom color from the color palette.
![Video showing how to apply duotone filter](https://wordpress.org/documentation/files/2023/12/image4-1024x580.gif)
To clear all the changes you made, use the clear button at the bottom right corner.
More option
The More option on a block toolbar gives you more features to customize the block. You have the option to copy, duplicate, and edit your block as HTML.
Read about these and other settings.
Block settings
Every block has specific options in the editor sidebar besides those found in the Block Toolbar. If you do not see the sidebar, click the ‘sidebar’ icon next to the Publish or Update button.
![Block Settings in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image6.png)
![Block Style Settings in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image11-276x1024.png)
Link to post
Turn on the ‘Link to post’ button in the Block Settings to link the featured image to the URL of the post. This enables the website visitor to go to the post by clicking on the Featured image. There is also an option to open the link in a new tab and set link rel.
![Link settings in the Post Featured Image block](https://wordpress.org/documentation/files/2023/12/image7.png)
Styles
Styles settings can be found on a second tab in block settings.
Color
Under color, options are available to set the overlay color and the opacity. Set the overlay color and adjust the opacity from 0 to 100, and you will notice its effect on the image.
It is also possible to use gradient as overlay if the theme supports gradient presets.
![Gradient overlay with 60% opacity](https://private-user-images.githubusercontent.com/1508963/292544262-c3cda069-6fd4-4a54-8b6f-390c707fc3d8.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTEiLCJleHAiOjE3MDMyNjQyMjYsIm5iZiI6MTcwMzI2MzkyNiwicGF0aCI6Ii8xNTA4OTYzLzI5MjU0NDI2Mi1jM2NkYTA2OS02ZmQ0LTRhNTQtOGI2Zi0zOTBjNzA3ZmMzZDgucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQUlXTkpZQVg0Q1NWRUg1M0ElMkYyMDIzMTIyMiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyMzEyMjJUMTY1MjA2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9N2RjYjVlYmIzNzhlNjY3YWY1MWMwMjM1NWIyZDljNTZlNDNlOWNlYjEyMGIyYmIzYTI1ZTQyZmQ3NjlmNTUwZCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.AGx2yte2XqMrnrxYqrwYKoc_VOaWI_cBzRN6zyv1_pc)
Filters
Duotone Filters can also be set from style settings. It works the same as the option available under the Block Toolbar (mentioned above).
Dimensions
Dimension controls are used to control how groups of blocks are placed alongside one another by changing the values for padding, margin, and other dimensions.
Available dimensions controls
- Padding
- Margin
- Aspect Ratio – changes the shape of your image, which may resulted in changing the size as well.
- Height & Width
Learn more about dimension controls.
Depending on the theme settings, aspect ratio could be different.
Border
Set the Border and Border radius of the image.
Detailed instructions on Border controls
Advanced settings
The “Advanced” tab lets you add CSS class(es) to your block. This will allow you to write custom CSS and styles to the block.
Inside the site templates
Featured image block can be added and managed inside site templates, if the theme supports the site editor.
Block settings here have a little more options than in a post or page editor, such as scale settings.
![Archive template screen with loop block, including featured image block](https://private-user-images.githubusercontent.com/1508963/292547350-49bc3add-c38a-498f-86af-ce54a3d977cd.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTEiLCJleHAiOjE3MDMyNjUxODIsIm5iZiI6MTcwMzI2NDg4MiwicGF0aCI6Ii8xNTA4OTYzLzI5MjU0NzM1MC00OWJjM2FkZC1jMzhhLTQ5OGYtODZhZi1jZTU0YTNkOTc3Y2QucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQUlXTkpZQVg0Q1NWRUg1M0ElMkYyMDIzMTIyMiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyMzEyMjJUMTcwODAyWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NzVkMTg1YWQ3MDkyMjVhNDNkYmUzOWYzOGQwMTMwMDk2MzU5ZWMzMDM5ZGExZGNkNDk2YzA4OGI1OGY5YjUxNiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.Ap9BOx7e5e4SjqaJffR-NEB4uz4W31jyxAh8dPcinM0)
Changelog
- Update 2023-12-22
- Add block placeholder screenshot
- Add gradient overlay
- Add Inside the site templates section
- Add aspect ratio video
- Update 2023-12-15
- Updated screenshots for 6.3
- Add Styles settings
- Created on 2022-03-17
Was this article helpful? How could it be improved?
Log in to submit feedback. If you need support with something that wasn't covered by this article, please post your question in the support forums.