File block

Go back to the list of Blocks

The File Block allows you to add a link to the downloadable files on your website.

In this video, you can see how to use the file block and the different settings to customize it.

How to add a File block to your post or page:

1. To add a File block, use the Block Inserter (+), or you can type /file in a new paragraph block and press enter.

Detailed instructions on adding blocks

2. To add a file, you can use the upload button to upload your files directly from your computer, or you can click Media Library to add files from your media library.

After you add a file, you can edit the file name by typing inside the rectangle. You can click Replace to replace the file and upload another one. You can click Copy URL to copy the URL of the file.

If you try to upload an unsupported file, you will see an error notification at the bottom-left corner of the screen.

3. Content-Only Editing Support

The File block supports content-only editing, allowing editors to update the block’s inner content—such as the file name and download button text—without modifying its structure or settings.

Key Features:

• Available when using Write mode in the Site Editor.
• Enables quick updates to file content in locked templates or sections.
• Matches behavior of other media blocks like the Image block.

Block toolbar

Every block comes with unique toolbar icons and block-specific user controls that allow you to manipulate the block right in the editor.

The File block has seven buttons:

• Transform to
• Drag icon
• Move handles
• Change alignment
• Replace
• Copy URL
• More options

Transform to:

The Transform button allows you to convert the File block into other block types while preserving its content.

• Image – Convert the file block into an image block if suitable.
• Columns – Place the file within a multi-column layout.
• Details – Wrap the file in a collapsible details/summary block.
• Group – Group the file with other blocks for shared styling.

The Group gives you the ability to change the background color around the File block.

Drag icon

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 handles

The up and down arrow icons can be used to move a block up and down on the page.

Get more information about moving a block within the editor.

Change Alignment

Using the alignment drop-down from the toolbar, you can align the file block to the left, make it center-aligned, or align it to the right. You can also make the file block wide width and full width.

Replace

Using the Replace button, you can replace your file by uploading a new one from your device or adding another one from your media library.

Copy URL

Click Copy URL to copy the URL of the file to your clipboard. You will see a message on the bottom left corner of your browser saying the URL has been copied.

More rich text controls

Clicking on the file name in the File block will display three more buttons in the Block Toolbar – Bold, Italic, and More Rich Text controls.

Use the “Bold” option or “Ctrl+B” / “Cmd+B” on your keyboard to bold it, which is usually heavier than the surrounding text.

Use the “Italic” option or “Ctrl+I” / “Cmd+I” on your keyboard to italicize it, which usually appears slanted to the right.

More rich text controls

Highlight

Use the Highlight option to change the color of the selected text and its background.

Inline code

Use the Inline code feature to format code snippets within your text differently. Not only that, but Inline code formatting also prevents the code to be executed instead of displayed.

Inline image

The Inline image feature allows you to add an image to your block. It has one option: enter the desired pixel width for your image.

Keyboard Input

The Keyboard Input option allows you to add the <kbd> tag to selected text.

Strikethrough

Use the Strikethrough option to place a horizontal line through the middle of the selected text.

Example: File Block

Subscript

Use the Subscript option to set the selected text slightly below the normal line of type.

Example: File _Block

Superscript

Use the Superscript option to set the selected text slightly above the normal line of type.

Example: File ^Block

More options

The More Options menu represented by three vertical dots on the far right of the toolbar gives you more features such as the ability to duplicate, remove, or edit your block as HTML.

Read about these and other settings.

Block settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, simply click the cog icon next to the Publish or Update button.

The File block offers the following settings

Settings

You can choose whether to link to the media file directly or a separate attachment page by using the drop-down menu. If you want the media file/attachment page to open in a new tab, enable the Open in a new tab button.

The File block comes with a Download button that can be toggled on and off using the Show download button.

By toggling it off, the file name will appear as a link.

If you upload a PDF file, you’ll see a PDF settings section on the block settings.

You can embed PDF on your page or post by enabling the Show inline embed option. When it’s enabled, you’ll see the height in pixels setting that lets you adjust the PDF display by using the slider or entering a value in pixels.

Styles

The Styles tab allows you to customize the appearance of the File block.

Color

Text and background colors can be set on a per-block basis, allowing you to call attention to important content. Using the Color settings, you can customize the block by adding text, background, and link colors.

See this guide for more information about changing colors.

Dimensions

The paragraph block provides various options to adjust its dimensions, such as width and height, allowing you to customize the text layout to ensure visual consistency.

For details refer to this support article: Dimension settings overview

Border

The paragraph block provides border settings options to add border color, width, and radius.

For details refer to this support article: Border settings overview

Advanced

The Advanced tab lets you add HTML anchor and CSS class(es) to your block.

HTML anchor allows you to make a unique web address for the File block. Then, you’ll be able to link directly to the File block on your page.

The Additional CSS class(es) lets you add CSS class(es) to your block, allowing you to write custom CSS and style the block as you see fit.