How to Upload and Manage Images and Files in the WordPress Media Library

Applies to: WordPress Websites Hosted or Managed by True Synergy Networks
Difficulty: Beginner
Estimated Time: 10–15 minutes

Overview

The WordPress Media Library is where your website stores uploaded images, documents, and other supported media files.

You can use the Media Library to upload photographs, add images to website pages, provide downloadable PDFs, and manage existing files without needing access to your website’s hosting server.

This guide explains how to upload files, find existing media, edit image details, insert files into pages, and safely remove media that is no longer needed.

Before You Begin:

• Sign in to your organization’s WordPress dashboard.
• Make sure your account has permission to upload media.
• Have your images or documents ready.
• Confirm that you have permission to publish the files.
• Use a supported, updated web browser.

Important: Files uploaded to the WordPress Media Library may be publicly accessible through their direct URLs, even if they are not linked from a published page. Never upload confidential documents, passwords, customer records, or private business information to the Media Library.

Understanding the Media Library

The Media Library is accessible from the WordPress administration dashboard.

It commonly stores:

• Company logos.
• Website photographs.
• Blog post images.
• Product and service graphics.
• PDF documents.
• Other supported files.

Media items may be used in multiple pages, posts, and website components.

Important: Deleting a file from the Media Library can affect every page that references it.

WordPress does not necessarily identify every place a file is being used, particularly when a website includes custom themes or plugins.

Step 1: Open the WordPress Media Library

1. Open your web browser.
2. Navigate to your organization’s approved WordPress administration address.

For most WordPress installations: https://example.com/wp-admin

Replace example.com with your actual domain.

3. Sign in with your assigned account.
4. Locate Media in the left navigation menu.
5. Click Library.

The Media Library should display files already uploaded to your website.

Step 2: Understand the Media Library Views

WordPress commonly offers two views.

Grid View

Grid View displays media as thumbnails.

This view is particularly useful for finding photographs, logos, and graphics.

List View

List View displays files in rows with additional information.

Depending on your WordPress version, you may see:

• File name.
• File type.
• Uploader.
• Upload date.
• Associated content.

Change Views

1. Open Media → Library.
2. Locate the view controls near the top.
3. Select Grid or List View.
4. Review the available files.

Note: The appearance of these views may vary depending on installed plugins and WordPress versions.

Step 3: Upload a New File

Open the Upload Interface

1. From the dashboard, click Media.
2. Select Add New Media File or Add New.
3. Wait for the upload interface to appear.

Select the File

1. Click Select Files.
2. Browse your computer.
3. Locate the image or document.
4. Select the file.
5. Click Open.

Complete the Upload

1. Wait for the upload to finish.
2. Review any displayed warnings.
3. Confirm that the file appears in the Media Library.

You can also drag files into the upload area where supported.

Important: Do not upload files that contain sensitive personal information or internal business data intended to remain private.

Understanding Supported File Types

WordPress supports several common file formats.

File Type	Common Formats	Typical Use
Photographs	JPG, JPEG, PNG, WebP	Website images and graphics
Graphics	GIF, PNG, WebP	Logos, graphics, and illustrations
Documents	PDF	Downloadable guides and forms
Audio	MP3, WAV	Approved audio content
Video	MP4 and certain other formats	Website media, when permitted

Note: Supported file extensions depend on your WordPress version, server configuration, security policies, and user permissions.

Important: Never change a prohibited file’s extension simply to bypass an upload restriction. Contact True Synergy Networks if you need an additional supported format.

Step 4: Find an Existing File

As your website grows, you may have many uploaded images and documents.

Search by File Name

1. Open Media → Library.
2. Locate the search field.
3. Enter part of the file name.
4. Review the results.
5. Select the appropriate file.

Filter by Media Type

Where available:

1. Open the media type dropdown.
2. Choose an appropriate type, such as Images or Documents.
3. Review the filtered results.

Filter by Date

1. Locate the date filter.
2. Select the appropriate month or year.
3. Review the matching files.

Tip: Give files recognizable names before uploading them to make searching easier later.

Step 5: View a File’s Details

1. Open the Media Library.
2. Click the file you want to review.
3. Wait for the attachment details window or editing page to open.

Depending on the file type, WordPress may display:

• File name.
• File URL.
• Upload date.
• File type.
• File size.
• Image dimensions.
• Title.
• Caption.
• Description.
• Alternative text.

Note: Not every field is available for every media type.

Step 6: Edit an Image’s Alternative Text

Alternative text, often called Alt Text, describes meaningful images for people using screen readers and may be used when an image cannot load.

Open the Image

1. Navigate to Media → Library.
2. Select the image.
3. Locate Alternative Text.

Enter a Description

Write a concise description of the image’s meaningful content.

Example:

“Technician configuring networking equipment in a small business office.”

Save the Change

1. Enter the description.
2. Save the change if prompted.
3. Confirm that the field contains the intended text.

Recommendation: Describe what matters about the image rather than stuffing the field with keywords.

Important: Decorative images may appropriately use empty alternative text. Also, changing alt text in the Media Library may not update alternative text already saved on individual Image blocks; check those blocks separately.

Step 7: Add an Image Caption

Captions display descriptive text associated with an image when the page or block is configured to show them.

Add a Caption

1. Open the image in the Media Library.
2. Locate Caption.
3. Enter the desired wording.
4. Save the changes.

Example:

“Our technicians installing a new business network.”

Note: A caption stored in the Media Library does not automatically appear everywhere the image is used. Its display depends on the page block or template.

Step 8: Understand Image Titles and Descriptions

WordPress may provide additional fields for images.

Title

The title helps identify the media item within WordPress.

A descriptive title can make it easier to manage.

Description

The description allows you to save additional information about the media.

Its public visibility depends on your website’s theme and how attachment information is displayed.

Important: Do not put confidential information in media titles, captions, descriptions, or file names.

Step 9: Insert an Existing Image Into a Page

Open the Page

1. Sign in to WordPress.
2. Navigate to Pages → All Pages.
3. Open the page you want to update.

Add the Image Block

1. Place your cursor where the image should appear.
2. Click the + button.
3. Search for Image.
4. Select the Image block.

Select the Image

1. Click Media Library.
2. Search for the intended image.
3. Select it.
4. Click Select or the available confirmation button.

Review the Image

1. Check the image’s position.
2. Adjust the available size and alignment settings.
3. Confirm that the alternative text is appropriate.
4. Preview the page.
5. Save or update the page when authorized.

Important: Updating a published page generally makes the change visible to visitors.

Step 10: Insert an Image Into a Blog Post

1. Open Posts → All Posts.
2. Select the article you want to edit.
3. Position your cursor where the image should appear.
4. Click +.
5. Select Image.
6. Choose Media Library.
7. Select the intended image.
8. Review its appearance.
9. Save or update the post.

Recommendation: Place images near the text they help explain.

Step 11: Set a Featured Image

A featured image is the primary image associated with a post or page.

Depending on your website’s theme, it may appear in:

• Blog article listings.
• Article headers.
• Related-post sections.
• Social sharing previews.

Set the Image

1. Open the relevant post or page.
2. Open the settings sidebar.
3. Locate Featured Image.
4. Select Set featured image.
5. Choose the image from the Media Library.
6. Confirm the selection.
7. Save or update the content.

Note: Featured image display is controlled by your site’s theme and templates.

Step 12: Upload a PDF Document

WordPress can store PDF documents for visitors to view or download.

Common examples include:

• Product brochures.
• Public instruction guides.
• Application forms intended for public distribution.
• Business service information.

Upload the PDF

1. Navigate to Media → Add New.
2. Select the PDF file.
3. Wait for the upload to finish.
4. Confirm that it appears in the Media Library.

Copy the PDF Link

1. Select the uploaded PDF.
2. Locate File URL.
3. Click Copy URL to Clipboard or copy the displayed address.
4. Save the URL for use in the appropriate page or post.

Important: The file URL can often be accessed directly by anyone who has the link. Only upload PDFs approved for public access.

Step 13: Add a PDF Download Link to a Page

Option 1: Link Existing Text

1. Open the intended WordPress page.
2. Highlight the text you want visitors to click.
3. Click the Link icon.
4. Paste the PDF’s URL.
5. Confirm the link.
6. Save or update the page.

Example Link Text:

“Download Our Service Guide”

Option 2: Use the File Block

1. Open the WordPress Block Editor.
2. Click +.
3. Search for File.
4. Select the File block.
5. Choose Media Library.
6. Select the PDF.
7. Confirm the insertion.

Depending on your WordPress version, the File block may display a link and an optional download button.

Recommendation: Use clear link text so visitors know what document they are opening.

Step 14: Replace an Image on a Page

If you need to use a newer photograph or updated graphic:

1. Open the page or post.
2. Select the existing Image block.
3. Click Replace in the block toolbar.
4. Choose Upload or Open Media Library.
5. Select the replacement image.
6. Confirm the selection.
7. Review the size, alignment, and alternative text.
8. Save or update.

Important: Replacing the image inside a page is not the same as replacing its original file in the Media Library.

Other pages using the old file may continue displaying it.

Step 15: Resize and Crop an Image

Some image adjustments can be performed directly in WordPress.

Open the Image Editor

1. Navigate to Media → Library.
2. Select an image.
3. Open Edit Image if available.

Review the Editing Controls

Depending on your WordPress version, you may be able to:

• Crop.
• Rotate.
• Flip.
• Scale the image.

Save the Changes

1. Make the intended adjustment.
2. Review the preview.
3. Save the image.

Important: Editing an image in the Media Library may affect how it appears in existing website content.

If you need a different crop for only one page, consider inserting a separate image or using the Image block’s available crop controls.

Step 16: Understand Image Sizes

WordPress may create multiple versions of an uploaded image.

These can include:

• Thumbnail.
• Medium.
• Large.
• Full Size.
• Additional theme-generated sizes.

These sizes help the website display images appropriately in different locations.

Choosing the Right Size

When editing an Image block:

1. Select the image.
2. Open the block settings.
3. Locate available image size options.
4. Choose an appropriate size.
5. Preview the layout.

Tip: Avoid displaying very small images at unusually large dimensions, as they may look blurry.

Step 17: Optimize Images Before Uploading

Large image files can slow down website loading.

Recommended Practices

• Use JPG or WebP for most photographs.
• Use PNG when transparency is necessary.
• Use appropriately sized images.
• Compress oversized photographs before uploading.
• Avoid uploading unnecessarily large source files.
• Use meaningful file names.

Example:

Instead of:

IMG_8492.jpg

Use:

business-network-installation.jpg

Important: Your website may automatically optimize images, but it is still beneficial to upload appropriately sized files.

Do not install new image optimization plugins without authorization.

Step 18: Delete an Unused Media File

Before deleting any file, confirm that it is no longer needed.

Delete a File

1. Open Media → Library.
2. Locate the file.
3. Open its details or available actions.
4. Select Delete Permanently, if available.
5. Review the confirmation.
6. Confirm the deletion only if authorized.

Important: Deleting media may permanently remove the file from WordPress.

Even if a media item appears unattached, it may still be used in a page, template, or plugin.

Recommendation: Contact True Synergy Networks before deleting old logos, sitewide graphics, or files with uncertain usage.

Understanding File URLs

Every uploaded media file typically has a direct URL.

For example:

https://example.com/wp-content/uploads/2026/10/company-brochure.pdf

The exact URL structure depends on your WordPress configuration.

Copy a File URL

1. Open Media → Library.
2. Select the file.
3. Locate File URL.
4. Copy the address.
5. Use it only where permitted.

Important: A file’s direct URL may remain accessible even if the page linking to it is private, unpublished, or deleted.

Do not treat the Media Library as secure private document storage.

Troubleshooting

I Cannot Find the Media Library

1. Confirm that you are signed in.
2. Look for Media in the navigation menu.
3. Check whether your user role allows media access.
4. Contact True Synergy Networks if the option is missing.

Note: Some WordPress accounts have limited upload permissions.

WordPress Says the File Type Is Not Allowed

If an upload is blocked:

1. Check the file’s extension.
2. Confirm that it is a supported format.
3. Verify that the file is appropriate for public website use.
4. Contact True Synergy Networks if the file type is required.

Important: Do not rename an unsupported file extension to bypass WordPress security restrictions.

My Image Upload Is Failing

1. Confirm that your internet connection is working.
2. Check the file format.
3. Verify that the file is not unusually large.
4. Try another approved image if necessary.
5. Review any displayed error message.

If the issue continues, contact True Synergy Networks.

WordPress Says the File Exceeds the Maximum Upload Size

1. Check the file size.
2. Compress or resize the file if appropriate.
3. Attempt the upload again.
4. Contact True Synergy Networks if the larger file is necessary.

Important: Upload size limits are controlled by the website and hosting configuration.

Do not modify server settings or install plugins to bypass these limits.

The Uploaded Image Looks Blurry

1. Open the image details.
2. Check its original dimensions.
3. Review its display size in the page.
4. Avoid stretching a small image beyond its natural resolution.
5. Upload a higher-quality version if necessary.

My Image Is Cropped Incorrectly

1. Open the page or post.
2. Select the affected image.
3. Review the image block’s crop or aspect-ratio settings.
4. Adjust the available controls.
5. Preview the result.

If the image is controlled by the website theme, contact True Synergy Networks.

My PDF Link Does Not Work

1. Open the Media Library.
2. Locate the PDF.
3. Copy its File URL again.
4. Open the address in a new browser tab.
5. Verify that it loads.
6. Update the page link if necessary.

If the file is missing or inaccessible, contact True Synergy Networks.

My New Image Is Not Showing on the Website

1. Confirm that the image was uploaded successfully.
2. Verify that you saved or updated the relevant page.
3. Open the live page.
4. Refresh the browser.
5. Allow time for website caching to update.

If the old image still appears, contact True Synergy Networks.

Note: Server caching or content delivery services may temporarily show the earlier image.

I Accidentally Deleted a File

If a file was deleted:

1. Stop making further changes.
2. Record the file name if known.
3. Contact True Synergy Networks.
4. Explain approximately when the file was deleted.

Important: WordPress media deletion is generally permanent through the normal interface. Recovery may depend on whether a suitable backup exists, and restoration is not guaranteed.

A File Appears Twice in the Media Library

If duplicate files are present:

1. Open both items.
2. Compare the file names and details.
3. Determine whether either file is used on the website.
4. Avoid deleting either item until its usage is confirmed.

Important: Similar-looking images may have different sizes, crops, or purposes.

My Image Is Not Appearing on Mobile Devices

1. Open the page in the Block Editor.
2. Review the image’s responsive settings if available.
3. Check whether the block is hidden for specific screen sizes.
4. Preview the mobile layout.
5. Contact True Synergy Networks if the issue continues.

Note: Some themes and plugins have device-specific visibility settings.

WordPress Displays an HTTP Error During Upload

If WordPress reports a generic upload error:

1. Check your internet connection.
2. Confirm the file type and size.
3. Retry the upload once.
4. Test with another appropriately sized file if permitted.
5. Record the error message.

If uploads continue failing, contact True Synergy Networks.

Important: Do not modify hosting permissions, PHP configuration, or server settings yourself.

Best Practices for Managing Website Media

When uploading and managing website files:

• Use descriptive file names.
• Optimize large images before uploading.
• Include alternative text for meaningful images.
• Use consistent graphics and branding.
• Keep photographs and documents relevant to the page.
• Upload only files approved for public access.
• Check PDF links after publishing.
• Avoid deleting media with uncertain usage.
• Do not upload copyrighted images without permission.
• Review website content after replacing images.
• Contact True Synergy Networks before changing advanced media settings.

Recommendation: Keep the original versions of important business photographs and documents in your organization’s approved file storage system rather than relying on WordPress as the only copy.

Additional Information

• The WordPress Media Library stores uploaded images, documents, and other supported file types.
• Media can be uploaded directly through the dashboard or from the Block Editor.
• Images can be inserted into pages and posts from the Media Library.
• Featured images are managed separately from images placed inside article content.
• WordPress supports alternative text, captions, titles, and descriptions.
• PDFs can be linked or inserted using the File block.
• Media files generally have direct URLs that may be publicly accessible.
• WordPress may generate multiple image sizes for different uses.
• Media deletion may permanently remove files from the website.
• True Synergy Networks manages hosting configuration, upload restrictions, caching, and advanced media troubleshooting.
  
  

---

Security Reminder: Only upload files that your organization has approved for public website use. Never place customer records, employee information, passwords, private financial documents, or other confidential material into the WordPress Media Library. Verify file contents before uploading, use properly licensed images, and do not delete media that may still be used elsewhere on the website. Contact True Synergy Networks immediately if sensitive information is accidentally uploaded or publicly exposed.