Custom Image Search: Instant Image Library For Your Business


Custom Image Search is a free service by MediaFocus to provide your business with an instant image library with no up-front cost. If you have an online printing business, produce greeting or business cards, promotional materials or anything else that licenses images – then MediaFocus's Custom Image Search is what you need.

With Custom Search, you can make our entire image library available and searchable by your users and on your site. This will drastically reduce image licensing costs for your business by allowing you to only license images that you will actually use. Powerful filtering and customization options will present a search page that blends in with your site's color scheme and display unbranded preview images to your customers. Optional account integration will further allow you to automatically license images your users chose and have it credited against your MediaFocus Image Subscription.

2.Free Membership Accounts

A Membership Account is required to use Custom Image Search and is Free to create. To create your Free Membership Account, please go to our Create Account page. Please be sure to provide all information required and provide a valid email since this email address will also be the email address that will receive image download emails. An email address may only be used to create one Membership Account. All information that you provide will be kept confidential and MediaFocus will never sell or otherwise share your data with any third parties. Please see our Privacy Policy for details.

To get started please log into your Membership Account, then go to the user's account area by clicking on the "my account" link found on the top right of the screen:

my account Image 1: Link location for "my account"

Once in the user's account area, find and click on the tab "Custom Search":

Custom Search Tab Image 2: Click on the tab "Custom Search" to set up your image search engine

3.Search Engine Pre-Filter

You are able to set up a pre-filter for your Custom Search. For example, if your business works exclusively with vectors, you can configure your pre-filter to exclude non-vector photos and images. The same concept applies to Shape and Size.

These pre-filters are not known by your users and cannot be overridden, except where noted below.

Custom Search Pre-Filters Image 3: Pre-Filter Options

With respect to Size pre-filtering, you can further specify if you want to allow the user to select sizes other than what you have set up:

  • Users are not allowed to select other sizes - default - This restricts the user only to the exact size you have chosen in your pre-filter.
  • Users may select other sizes smaller than above - This allows the user to select any other image size smaller than that in your pre-filter and up to the size you have set.

4.Layout Options

On the Layout panel, you can customize how you want the search and results page to appear on your site. While you'll probably want all options enabled, you are able to make some adjustments to better suit your style. The preview section on the right will give you a live preview of how your selection will affect the appearance:

Layout Options Image 4: Layout Options
  • Thumbnail Style - Choose from the "photo slide" style or the more modern grid lines layout of the thumbnail images for search results.
  • Thumbnail Info - Select what image information you want to show for each thumbnail. Less information will present with a more cleaner look.
  • Search Page Layout - Select which on page search elements you want displayed. Hiding the Top Header will give more room for the thumbnails. Advanced Search allows the user to refine their search by Type, Shape, Size and Color. However, only those options which are not restricted by your pre-filter will be available.

5.Layout Colors

To better integrate the Custom Image Search into your site, you may set the colors of various elements of the search page to better fit into your site's color scheme. The preview section on the right will give you a live preview of how your selection will affect the appearance:

Layout Colors Image 5: Layout Colors
  • Background - This is the page's main background color where the thumbnails will be displayed against and is also the background color for the image detail page.
  • Header - This is the background color for the Top Header section where the main search box is displayed.
  • Header Border - This is the border bar just underneath the Top Header, separating the header from the main thumbnail section below it.
  • Advanced Search - This is the background color for the Advanced Search panel on the left.

6.Image Selection Method & Integration

After setting up the pre-filters and look and feel of your Custom Image Search comes the most important part – site integration. Here, you will select what will actually happen when a user on your site selects an image to use. There are many different options, each offering an increasing level of integration to make the image shopping seamless for your visitors. However, full integration would require some minor development on your part.

Note that not all options will be available at all times as some options are dependent on the selection made before it.

Image Selection Integration Image 6: Image Selection Integration
  1. DO NOT show Image Detail page on my site. Open MediaFocus Image Detail page in separate window.

    This is the simplest option. Here, when a user on your site clicks on an image thumbnail, a new browser window is opened and they are taken to that images's detail page on MediaFocus's site. This is where the user would make their image licensing purchase with their own account and their own payments. All purchasing communication is between the user and MediaFocus and you are out of the loop. With this option, there will be no further option to select. Click Save to save all your settings and then click on the "Your Code" tab to get the integration code.

  2. Show Image Detail page on my site.

    With this option, when the user clicks on an image thumbnail, they will be taken to the image detail page for that image on your site. There the user will see a larger, unbranded preview image as well as that images's keywords. They will also see all the sizes available for that image limited by your pre-filters settings for Size, if you had set up any. At this point, the user still remains on your site.

    When displaying the Image Detail on your site, you will then need to select how you want your user be able to license images:

    1. Redirect to MediaFocus Image Detail page. MediaFocus will conduct all transactions.

      Similar to the first option "DO NOT show Image Detail page ..." with the only difference being that the image detail page that the user sees first is on your site. All licensing transaction will still be between the user and MediaFocus and you are out of the loop.

    2. User will select Image Size on my site and my account will be charged. (full integration)

      This option implements full integration with your site. Here, your user will select the desired image size on the image detail on your site. After selecting the image size, the user will either receive a success "Thank You" message on the page, or an error message of something wrong occurs. The user always stays on your site.

      The image selected by your user will be licensed to you under your MediaFocus account. This requires that you validate your site and also have an active Image Subscription with MediaFocus in good standing.

      Verify Site

      To be able to integrate user image licensing on your site, you must first verify that you have authorized root level access. To do this, enter your site's domain where you intend to integrate the Custom Search Engine in the field marked "Your Web Site Address". Then place an empty text file on your site with the name of your Custom Search API ending with ".txt" and click "Verify".

      Site Verification Fields Image 7: You must verify your site for successful integration

      If the MediaFocus back-end process is able to locate the api key file, then your site is verified, indicated by the word "Verified" in green next to the Site Address field.

      Site Verified Image 8: Site verification successful

      DO NOT remove this file once your site is verified. It is routinely accessed by MediaFocus to ensure continued verification.

      Image Subscription Integration

      Full integration will allow your user to select the image size on your site and generate a download link to the email on your account. This requires an active Extended License Image subscription for the downloads to be credited against.

      • If an active subscription is not found for your account of if the allotted images is depleted, the user will receive an error message indicating that their image selection could not be processed.
      • In either cases of a successful or unsuccessful image selection, your will receive an email notifying you of the selection and the status.
      • For successful image selections, the email will also contain a download link for the image.

7.Integration Code

Click "Save" at any time to save your settings and site verification status. Then click on the "Your Code" tab.

Integration Code Image 9: Integration Code

Simply copy the entire HTML code here into your web page where you want to use Custom Image Search. It's that easy! You are free to modify the width, height and style attributes to fit your site however you wish. However, you must not modify the value for the "src" attribute except for the "ref" value if you wish to include custom data that will be recorded with any image selection your user makes if you are using full integration.

Custom "ref" Value

To help you better integrate your business with the Custom Image Search, you are able to include your own custom reference data from your system to be included each time you serve of the page containing the search to your users. This may include information such as customer number, order number or anything else you need to be able to reference an image download email to a user order. MediaFocus does not use this information in any way. It is simply included in the download email sent to you.

This reference data cannot be larger than 50 characters and must be properly url encoded.

stock photos

member login
my cart
create free account
My Cart