Welcome to the WPMediaPicker documentation! Here, you will find detailed information on how to use the WPMediaPicker plugin, which provides a powerful media picker interface for your WordPress website. Whether you want to streamline your media selection process or enhance your user experience, WPMediaPicker allows you to effortlessly manage and display your media files. Read on to learn more about its features and how to integrate it into your WordPress site.


1. Requirements

Before installing WPMediaPicker, please ensure your WordPress site meets the following requirements:

  • WordPress version 4.7 or higher
  • PHP version 5.6 or higher

2. Installation Steps

Follow these steps to install and activate the WPMediaPicker plugin:

  1. Download the WPMediaPicker plugin zip file from the official WordPress repository or any trusted source.
  2. Log in to your WordPress admin panel.
  3. Go to “Plugins” and click on “Add New”.
  4. Click on the “Upload Plugin” button.
  5. Select the downloaded zip file and click “Install Now”.
  6. Once the installation is complete, click “Activate Plugin”.

Getting Started

1. Media Picker Settings

To configure the media picker settings, follow these steps:

  1. Go to your WordPress admin dashboard.
  2. Navigate to “Settings” and click on “WPMediaPicker Settings”.
  3. Here, you can customize various options such as allowed file types, maximum file size, and more.
  4. Save your changes once you have configured the desired settings.

2. Using the Media Picker

Utilize the media picker within your WordPress site with the following steps:

  1. Open the page or post editor where you want to add media.
  2. Click on the “Add Media” button located above the content editor.
  3. A popup window will appear with the media picker interface.
  4. Here, you can browse, search, and select your desired media files.
  5. Once you have selected the desired files, click “Insert” to add them to your page or post.

3. Displaying Media

After adding media to your WordPress site, you can display it using various methods:

  • Shortcode: Use the [wpm_picked_media] shortcode to display a gallery or a single media item.
  • Widget: Add the “WPMediaPicker Widget” to your widget areas to display media from your selected galleries.
  • Template Tag: Utilize the provided template functions to display media programmatically in your theme files.
  • Block Editor: In the Gutenberg editor, you can insert media blocks and customize their display settings.

Frequently Asked Questions

1. How can I update the version of WPMediaPicker?

To update WPMediaPicker to the latest version, follow these steps:

  1. Log in to your WordPress admin panel.
  2. Go to “Plugins” and click on “Installed Plugins”.
  3. Locate “WPMediaPicker” from the plugin list and deactivate it.
  4. Delete the deactivated version of WPMediaPicker.
  5. Follow the installation steps mentioned above to install and activate the latest version of WPMediaPicker.

2. Can I limit the media picker to specific file types?

Yes, you can limit the allowed file types within WPMediaPicker. To do this, navigate to “Settings” and click on “WPMediaPicker Settings” in your WordPress admin dashboard. In the settings page, find the “Allowed File Types” option and enter the extensions of the desired file types. Save the changes to apply the restrictions.

3. How can I change the maximum file size for uploads?

To modify the maximum file size for uploads through WPMediaPicker, access the “WPMediaPicker Settings” from the WordPress admin dashboard. Look for the “Maximum File Size” option and adjust it according to your requirements. Remember to save your changes for the new limit to take effect.

4. Is WPMediaPicker compatible with other media-related plugins?

WPMediaPicker is designed to be compatible with most WordPress plugins that work with media files. However, conflicts or unexpected behavior may occur if using similar plugins with overlapping functionality. It’s recommended to thoroughly test compatibility when integrating WPMediaPicker with other media-related plugins.

5. How can I customize the appearance of media galleries?

The appearance of media galleries can be customized using CSS or by modifying the templates. If you are using the Gutenberg editor, you can also adjust the gallery block settings to control its layout and other display options.


Congratulations! You now have a comprehensive understanding of WPMediaPicker and how to use its media picker interface efficiently. Explore its various options, settings, and integration methods to enhance your WordPress site’s media management capabilities. Should you have any further questions or need assistance, feel free to consult the WPMediaPicker support resources or reach out to the plugin developers.