How to embed media and documents in WordPress
WordPress can embed many media sources without a plugin: paste a supported URL into an Embed block, or use Image, Gallery, Video, Audio and File blocks for uploads. For PDFs, enable inline display in the File block. Use an embed product when you need more sources or controls.
- 01Choose the right content block
- 02Embed external media by URL
- 03Upload files from your library
- 04Display a PDF inline
- 05Fix embeds that fail
- 06Use a broader embed tool
What you need
- A WordPress site with editor access
- The media URL or files you want to add
- HTTPS enabled for the site and external media where required
Choose the right content block
Use an Image, Gallery, Audio, Video or File block for files uploaded to your WordPress Media Library. Use the Embed block when the content remains on another service, such as YouTube, Vimeo or SoundCloud.
WordPress has separate blocks for many common services, but a generic Embed block can also accept a supported URL. It creates a connection to the external content rather than copying that content into your Media Library.
Embed external media by URL
Open the post or page, add an Embed block, paste the public URL and select Embed. WordPress will convert it to the relevant service block when the provider is supported.
Use the provider's normal public page URL, not a private dashboard link. If WordPress shows the URL as plain text or reports that it cannot embed it, the service may not be on WordPress's supported provider list, the item may be private, or the URL may not be an embeddable page.
Upload files from your library
For your own images, audio, video or documents, add the matching media block and choose Upload or Media Library. Add descriptive text where the block provides it, especially alternative text for images, then check the block settings for alignment, dimensions, captions, links and download controls.
The Gallery block is intended for groups of images, while the File block provides a file link and optional download button. WordPress may reject file types that your site does not allow.
Display a PDF inline
Add a File block, upload or select the PDF, then enable Show inline embed in the block settings. Keep the download button enabled unless you have a clear reason to remove it, because visitors still need a fallback when a browser cannot display the viewer.
This native option is fine for a straightforward PDF. It is not a full document library or flipbook, and the appearance can vary between browsers, screen sizes and themes. Always open the published page on a phone as well as a desktop browser.
Fix embeds that fail
First open the original media URL in a private browser window. Confirm that it is public, still exists and loads over HTTPS. Then try the service-specific block instead of the generic Embed block, or replace a share link with the provider's public viewing URL.
For PDFs, test the direct file link as well as the inline viewer. If the file opens directly but the inline frame is blank or cut off, the problem is usually the browser viewer, a theme layout rule, caching, or a plugin conflict rather than the PDF itself. Check the page with other plugins temporarily disabled before adding custom code.
Use a broader embed tool
The manual route is usually enough for common YouTube videos, images, galleries, audio, video and PDFs. Choose EmbedPress Pro when you need broader source coverage across major WordPress editors, reusable embed controls or support for many media and document services without writing custom code.
That is the fast route: install and activate the product, insert its embed element in the editor you use, then paste the source URL or select the document. You still need to check the provider's permissions and review the published result on mobile.
Let EmbedPress Pro do it
Embeds 75+ media and document sources across major editors; choose it for broad content support without custom code.
Sources
- wordpress.org /documentation/article/embed-block/?utm_source=openai
- wordpress.org /documentation/article/file-block/?utm_source=openai
Questions
- Can I embed media in WordPress without a plugin?
- Yes, WordPress can embed many common media sources without a plugin. Use the relevant core block for uploaded images, galleries, audio, video and files, or paste a supported third-party URL into the Embed block. A plugin becomes useful when the source is unsupported, you need advanced document viewers, or you want one interface for many services.
- Why does my WordPress embed appear as a plain link?
- A plain link usually means WordPress could not recognise or fetch an embeddable source. Check that the URL is public, uses HTTPS and points to the provider's viewing page rather than a private or editing page. The service may also be unsupported, in which case use the provider's embed code or a dedicated embed tool.
- How do I embed a PDF in a WordPress page?
- Add a File block, upload the PDF or choose it from the Media Library, then enable Show inline embed in the block settings. Leave a direct file link or download button available as a fallback, because some browsers, themes and mobile layouts do not display inline PDF viewers correctly.
- What is the difference between embedding and uploading media?
- Uploading stores the file in your WordPress Media Library and gives you control over its link, metadata and block settings. Embedding keeps the content on an external service and displays it through a link or provider-generated frame. External embeds can stop working if the provider changes its permissions, URL format or service.