Uploading Files via the WordPress Dashboard
This article discusses the methods of uploading files through your WordPress Dashboard.
Please click the links below for more information.
- What file can be uploaded in WordPress? ⤵
- How to upload a file into WordPress ⤵
- The Media Library ⤵
- Related Articles ⤵
What file can be uploaded in WordPress?
WordPress supports uploading of multiple file types, which includes but are not limited to the following:
- .gif (Graphics Interchange Format)
- .jpg; .jpeg (Joints Photographic Experts Group)
- .png (Portable Graphics Format)
- .svg (Scalable Vector Graphic)
- .3gp (3GPP)
- .3g2 (3GPP2)
- .mp4, .m4v (MPEG-4)
- .mov (QuickTime)
- .ogv (Ogg)
- .wmv (Windows Media Video)
- .doc, .docx (Microsoft Word Document)
- .odt (OpenDocument Text Document)
- .pdf (Portable Document Format; Adobe Acrobat)
- .ppt, .pptx, .pps, .ppsx (Microsoft PowerPoint Presentation)
- .psd (Adobe Photoshop Document)
- .xls, .xlsx (Microsoft Excel Document)
How to upload a file into WordPress
Files can be uploaded into the WordPress Dashboard by two separate means.
Please click the links below for more information.
Direct upload into a page or post
One method of uploading files is directly into the page or post. If you have already started creating a page or post, you can upload a file using the WordPress block editor. Blocks are the smallest, most basic unit you’ll use in the editor and can contain anything you’d want to include on a page or post - text, images, videos, audio, buttons, and custom code, to name a few examples.
To upload a file on a page or post using the block editor:
- On the Dashboard menu, select Pages and then click Add New.
- On the new page, click the block inserter icon located at the top left or at the workspace area to add a block.
- Search for the file type you want to upload using the search menu. You can also scroll through the categories until you find the Media section under the Block tab.
- Select the file type icon from the list (or search results) to add the media block to the page's workspace area.
- On the media block (for example, Image block), click Upload to open a dialogue box, where you can select the file you want to upload.
You may also use the Media Library if you have already uploaded a media file to your WordPress Media Library beforehand. To know how to upload files directly to your Media Library, please go to Upload via Media Add New screen section below.
- The Image block should now display the uploaded image. Click the block to show the Image block settings.
- Once done, click the Save the draft, Preview, or Publish buttons in the top-right section of the page or post.
Upload via Media Add New screen
With the Media Add New screen, you can upload single or bulk media files (image, video, audio, etc.) into the Media Library and use them later on for your pages or posts. There are two methods for uploading files into the Media Library - the Multi-file uploader and the Browser uploader. The Multi-file uploader is the primary method, but you can click the browser uploader link to upload your files if you're having issues using this.
To upload a media file(s) using the Multi-file uploader:
- Log in to your WordPress Dashboard.
- Select Media from the left menu, then click Add New.
- In the Upload New Media section, click Select Files to open a dialog box where you can upload multiple files. You can also drag and drop file(s) from your local computer to the upload area.
Depending on your host's upload_max_filesize settings, the maximum file size you can upload varies. If you're on Shared hosting, you can upload up to 512M. For more information about your hosting's PHP settings, please check the article, What is php.ini? Please note that there are also PHP settings that cannot be changed, especially on Shared hosting plans.
- A status bar will be displayed next to each file to indicate the upload progress.
- Once completely uploaded, the file's thumbnail and details will be displayed. You can click the Copy URL to clipboard to copy the file's URL or Edit to edit and save information about the uploaded file.
The file(s) are now stored in the Media Library section.
If you're experiencing problems uploading media files using the multi-file method, you can use the Browser Uploader instead.
To upload a file via the Browser Uploader:
- On the Upload New Media page, click the Browser Uploader link.
- Click Choose File to display a dialog box where you can select files to upload.
- Click on the Upload button to initiate the uploading process.
The Media Library
The Media Library is a collection of media files you've uploaded into your WordPress Dashboard. This is where you can search, filter, edit, view, and delete the media files previously uploaded to your site.
The Media Library has two types of view:
With the Grid view, all thumbnails of files are displayed in a grid.
The Grid view allows you to search for your file using the search box on the right. You can also use the filtering options:
- All media types - This filtering option shows all media files uploaded into your Media Library. You can also choose to filter by Images, Unattached and Mine.
- All dates - This option displays files based on their upload dates.
Click a file's thumbnail to show the attachment details. The Edit Media page will allow you to preview your media file and make quick edits. The details seen in this section vary depending on the uploaded file type.
Here are some of the details in the Edit Media section.
- Uploaded on - This shows the date when the file was uploaded.
- Uploaded by - This shows the author who uploaded the file.
- Uploaded to - This shows the page or post's title that contains this particular media. This section is not displayed if the media file is not attached to any page or post.
- File URL - This is the uploaded file's read-only URL.
- File name - This displays the file's complete file name.
- File type - This shows the file's media type. (For example, JPG, PNG, etc.)
- File size - This is the size of the file.
- Dimensions - For images, this section displays the image file's dimensions.
- Alternative text - For images, the Alt Text section shows the text to describe the image file.
- Caption - Briefly explains the media file.
- Description - This provides an explanation of the particular media file.
- Artist - For voice files, this shows the media file's singer, composer, or producer.
- Album - For voice files, this shows the album title of the media file.
The List view displays your media files in a table with the newest uploaded file at the top.
The Screen Options located at the top right allows you to select the columns and number of items per page you want to display on your list.
Hover over your media files to see the link menus below each file.
- Edit - This allows you to edit, such as rotate, scale, and crop your media file.
- Delete Permanently - This deletes your file from your Media Library.
- View - This will show you how the image would look when displayed in your current theme.
- Attach - This link will be displayed under the Uploaded to column for media files that are not yet attached to a page or post. Click Attach to attach the file to a selected page or post.
With List view, you can search for your media file using the search box or use the filtering options:
- All - With this dropdown, all media file types are displayed. You can also choose to filter by Images, Unattached and Mine.
- All dates - - This option displays files based on their upload dates.
You can select Bulk Action or Delete Permanently from the dropdown and apply them to selected files on the list by clicking the Apply button.
Want to learn more about WordPress? Here are helpful articles to guide you with your WordPress journey.
- What is WordPress?
- Guide to WordPress Themes
- Guide to WordPress Block Editor
- Guide to WordPress Pages and Posts
- Guide to WordPress Plugins
- Guide to Publishing a WordPress Page or Post