Uploading Media
The WordPress Media Library manages images, documents and other uploaded files. Files are normally stored under wp-content/uploads, while their titles, captions and attachment details are kept in the database.
Prepare a file before uploading
- Use a descriptive filename without private customer information.
- Resize images to suit their intended display size.
- Choose an appropriate web format and compress large images.
- Check that documents are current and intended for public access.
Upload and add media
- Open Media > Add New Media File, or add an image or file block while editing content.
- Select or drop the file into the upload area.
- Add alternative text that describes the purpose of an informative image.
- Add a caption or description only when it helps visitors understand the file.
- Insert the item into the page and preview how it appears on desktop and mobile.
If the upload does not complete
Check the displayed maximum upload size, file type, filename and available hosting storage. PHP and server limits can also affect uploads. Follow Media Uploads Failing for troubleshooting guidance.
Common questions
Frequently Asked Questions
Where does WordPress store uploaded files?
They are normally stored under wp-content/uploads, often in year and month folders. The Media Library stores information about those files in the database.
Should every image have alternative text?
Informative images should have useful alternative text. Purely decorative images can use empty alternative text so assistive technology can ignore them.
Can I upload videos directly to WordPress?
You can when the host allows the file type and size, but large video files can use substantial storage and bandwidth. An appropriate video hosting service is often more efficient.
Why does WordPress reject my file?
The file may exceed an upload limit, use a blocked type, have an unsuitable filename or fail because of storage, permissions or server processing.