Sell Media Plugin Instructions


  1. Activate the plugin.
  2. Visit Sell Media -> Settings and configure the options.
  3. Visit Sell Media -> Licenses and add or configure your default licenses for new uploads.
  4. Visit Sell Media -> Add New and upload an image, video, audio file or pdf for sale.
  5. Insert the Sell Media shortcode onto any Post or Page.


Will this plugin work with my theme?

Sell Media is theme agnostic – meaning that it should work with any theme. If Sell Media looks wonky in your theme, please let us know.

What are shortcodes and how do I use them?

Shortcodes are small snippets of code that when added to a Post, Page or Widget add functionality to your site. Sell Media uses shortcodes to:

  • Display the Checkout Cart – [sell_media_checkout]
  • Display the Thanks page – [sell_media_thanks]
  • Display a Buy Button for a specific item – [sell_media_buy_button]
  • Display a Search Form for Sell Media items – [sell_media_searchform]

How do I show my checkout cart?

  1. Create a page called “Checkout” and add this shortcode to the page: [sell_media_checkout]
  2. Visit Sell Media -> Settings and select the Checkout page you created above to the “Checkout Page” option.

How do I show an item available for sale?

You have two options:

  1. After adding a new item for sale on the Sell Media -> Add New page, copy and paste the shortcode at the bottom of the screen into a Post, Page or Text Widget. This shortcode will embed the image and an “Add to Cart” button below the image. The shortcode looks something like this: [sell_media id=”257″ text=”Purchase” style=”button” color=”blue” size=”medium”]
  2. Each item you add for sale also has a dedicated URL. Click the View Item button after saving your first Sell Media item. You could then add the link to that specific item to one of your Menus on Appearance -> Menus -> Custom Menu Item.

How do I bulk upload images for sale?

  1. Click Media -> Add New
  2. Simply drag and drop your files into the box that appears, or click Select Files to choose a file from your computer to upload. Please keep in mind that the drag and drop uploader only works in browsers with HTML5 upload support such as the latest versions of Chrome, Firefox, or Safari. Other browsers will still show the Select Files button or the basic browser uploader form.
  3. When a file has finished uploading, click the Show link on the right.
  4. Check the Sell This option. Repeat for each item you want to sell and click Save.
  5. This item will be added as a new entry in Sell Media. By default, the newly created Sell Media item will inherit the prices and licenses that you chose on Sell Media -> Settings. You can modify the price and available licenses on the Sell Media tab by editing each individual item.

Sell Media includes a new “Collections” taxonomy, which you can see on the right side of the screen when adding a new item to Sell Media. Assign each item to a specific Collection and the items will be displayed on that specific collection’s archive page. You can then link to the collection like this: A list of collecitons also shows up on the Appearance -> Menus page so you can add them to any menu.

How do I password protect an item?

The Password Protection option is located in the Publish box when editing a Sell Media item. Click the Visibility – Public – Edit link, select Password Protected, type in a password and click Save.

How do I password protect a collection?

*This feature will only be available in version 1.0*

Click Sell Media -> Collections -> Add New and fill in the password protect field.

How do I hide a collection from being listed on archive pages?

Click Sell Media -> Collections -> Add New and check the “Hide from Archives” option.

How do I increase the maximum upload size in WordPress?

Depending on the web hosting company you choose and the package you select, each of you will see maximum file upload limit on your Media Uploader page in WordPress. For some it is as low as 2MB which is clearly not enough for large images or videos. You can increase this by doing one of the follwing:

  1. Theme Functions File – There are cases where we have seen that just by adding the following code in the theme function’s file, you can increase the upload size:
    @ini_set( ‘upload_max_size’, ’64M’ );
    @ini_set( ‘post_max_size’, ’64M’);
    @ini_set( ‘max_execution_time’, ‘300’ );
  2. Create or Edit an existing PHP.INI file – In most cases if you are on a shared host, you will not see a php.ini file in your directory. If you do not see one, then create a file called php.ini and upload it in the root folder. In that file add the following code:
    upload_max_filesize = 64M
    post_max_size = 64M
    max_execution_time = 300
  3. htaccess Method – Some people have tried using the htaccess method where by modifying the .htaccess file in the root directory, you can increase the maximum upload size in WordPress. Open or create the .htaccess file in the root folder and add the following code:
    php_value upload_max_filesize 64M
    php_value post_max_size 64M
    php_value max_execution_time 300
    php_value max_input_time 300

Again, it is important that we emphasize that if you are on a shared hosting package, these techniques may not work. In that case, you would have to contact your web hosting provider to increase the limit for you.

Transactions are not posting. Why?

Please visit the Add Media -> Settings -> Payments page and double check all of your settings. Also, if you are using Paypal, you need to make sure you have added your IPN Listener URL to Paypal.

What are license types?

The Sell Media plugin helps you to create and assign different licenses and prices for each image, video or audio file based on the anticipated usage of the media. For example: If a large company wants to purchase one of your images for a billboard, you should charge one price for commercial usage, charge another for editorial, and so on.


Example for adding a message above the cart:

function sell_media_above_cart_function() {

print "This message will show up above the cart on the cart popup. You could include a copyright message or links to your terms of service.";

add_action( 'sell_media_above_cart', 'sell_media_above_cart_function' );

Example for adding a message below the cart:

function sell_media_below_cart_function() {

print "This message will show up below the cart on the cart popup. You could include a copyright message or links to your terms of service.";

add_action( 'sell_media_below_cart', 'sell_media_below_cart_function' );

Action hooks available:

  • sell_media_above_cart – Above the cart
  • sell_media_below_cart – Below the cart
  • sell_media_cart_below_licenses – Between license and price on cart
  • sell_media_menu_hook – settings.php – Use for adding new submenu pages
  • sell_media_register_settings_hook – settings.php – Use for registering new settings/options
  • sell_media_settings_above_general_section_hook – settings.php – Above tables on settings page
  • sell_media_settings_below_general_section_hook – settings.php – Below tables on settings page