Skip to main content

Getty Images

The Getty Images integration provides access to an enormous library of images. When you identify an image to use, you import it into Brightspot and then add it to assets such as articles and galleries.

This section describes how to configure the integration in Brightspot, and how to perform an integrated search.

The integration requires a Getty Images account. See gettyimages.com.

Including Getty Images in a build​

The following table lists the dependencies to include in your build configuration.

ArtifactDescription
com.psddev:gettyExposes the external type GettyImage and fields in Edit Site to configure and run integrated search with Getty Images.

Runtime prerequisites​

  • Developer configuration—Extend ExternalItemConverter to import the GettyImage as a Brightspot Image.
  • Ops configuration—Generate an API key and secret; you may need to contact your Getty Images representative for assistance.
  • CMS configuration—Configure the site interfacing with Getty Images. For details, see Configuration.

Configuration​

You can configure integrated search with Getty Images at the Global level or the site level. Global configurations are inherited by all sites, and site-level configurations override Global configurations. This topic explains how to configure this integrated search at the Global level.

To configure integrated searches with Getty Images:

  1. In your Getty Images console, obtain your API key and secret.

  2. Click > Admin > Sites & Settings > Sites > Global.

  3. From the Integrations tab, expand the Getty cluster.

  4. Toggle on Download Full Images to download a Getty Image's largest display size. Depending on your agreement with Getty Images, this may incur additional costs since it entails making an additional request at the time of import.

  5. From the Getty API Client list, click Create New.

  6. In the Name field, enter a name for the integration.

  7. In the API Key and API Secret fields, paste the values from step 1.

  8. Click Save.

  9. Click Back.

  10. From the Getty API Client list, select the integration you created.

    5.0-set-a-getty-images-api-client

  11. Click Save.

Importing a Getty Images image​

Use the following procedure to search for and use an image from Getty Images.

To search for and use a Getty Images image:

  1. Open the search panel.
  2. Set the content types filter to Getty Image.
  3. Add other filters or search text. For additional information, see Search filters. Brightspot lists any matching images.
  4. Click an image.
  5. In the content edit form, click Import.

Brightspot imports the image and displays it in a content edit form. You can modify the title, caption, credit, or other metadata, and then use the image in an asset.

For additional information about importing external assets, see Syncing with external images.

See also: