Hello World tutorial (videos)

This tutorial takes you through the necessary steps to start using Image and Video Manager to manage and optimize your short-form videos.

You'll learn how to:

  • Add the Image and Video Manager (Videos) rule and behavior to a property
  • Create a video policy to automate video optimizations


Before you begin, make sure you meet the following prerequisites.

You will need:

  • A login to ‚ÄčAkamai Control Center‚Äč
  • Access to Property Manager
  • A contract that includes Image and Video Manager
  • An active web performance configuration
  • A property corresponding to the website with the videos you wish to optimize

If you do not have a web performance configuration, you will need to create one.

For more information about creating a property, see the Property Manager documentation.

Tutorial outline

This table provides a high-level overview of the tutorial.

Connect your videosAdd an Image and Video Manager (Videos) rule with an Image and Video Manager (Videos) behavior to a property to connect your videos to Image and Video Manager.
Create your policyCreate a video policy.
Configure your optimization settingsSpecify your tolerances for the quality and width of the derivative videos created by Image and Video Manager.
Activate your policySave and activate your policy in the staging environment.

Connect your videos

To connect your videos to Image and Video Manager, you must create an Image and Video Manager rule for the appropriate property. Rules include match criteria and behaviors. If a request fulfills the conditions in the match criteria, your web performance product applies the behaviors in the rule.

Create the rule

  1. Log in to ‚ÄčAkamai Control Center‚Äč.

  2. Go to ‚ėį > CDN > Properties.

  3. Click the property to which you want to add the Image and Video Manager rule.

  4. On the property details page, click the version of the property configuration you want to edit.

  5. Click Add Rule in the Property Configuration Settings section.

  6. Search for and select Image and Video Manager (Videos) in the list of available rules.

  7. Click Insert Rule.

Specify the match criteria

In the Criteria section, create an If statement by:

  • Selecting File Extension from the first list
  • Selecting is one of from the second list
  • Selecting all of the required video file extensions for your videos

Add the behavior

  1. Click Add Behavior.

  2. Search for and select Image and Video Manager (Videos) in the list of available behaviors.

  3. Click Insert Behavior.

  4. Configure the behavior as indicated in the following table.

EnableToggle On to allow Image and Video Manager to apply optimization settings to your videos and to generate the API keys.
Automatic breakpoint selectionToggle On to let the Image and Video Manager algorithms choose the best derivative video width for the requesting device's screen size and resolution.
Use Best File TypeToggle On to automatically convert videos to the best file type for the requesting device. This results in the smallest file size that retains video quality, based on the user agent and the original pristine video.
RegionChoose the location closest to your website's heaviest traffic. If this varies, choose United States.
Pristine Videos CP CodeSelect the CP code to track video traffic between IM and your origin.
Derivative Videos CP CodeSelect the CP code to track traffic serving derivative videos to end users.
Apply Existing Policy SetToggle to No to automatically create a new policy set to associate with this property.
Policy Set TypeToggle to Standard to use the standard policy set name, which is based on your property name.
Policy Set Name (API Key)Note this name and record it somewhere you can find it later. This name associates a set of Image and Video Manager policies with this instance of the Image and Video Manager (Videos) behavior.
  1. Click Save.

Configure your video policy

A video policy contains configurable settings to automate:

  • Video optimizations such as derivative video quality and derivative video resolution

  • A placeholder video that plays while the requested video video loads

There are two ways to create a new video policy:

  • By toggling Apply Existing Policy Set to No in the Image and Video Manager (Videos) behavior in the Image and Video Manager (Videos) rule. This results in the automatic creation of a new policy set with a default policy.

  • By logging in to ‚ÄčAkamai Control Center‚Äč, navigating to ‚ėį > CDN > Image and Video Manager, and using the Policy Manager tools.

In this tutorial, you will edit the default policy that was already created when you created your rule. You will configure video optimization settings and saving your policy.

Open your policy in Video Policy Editor


New Policy Manager UI

These instructions reflect the new beta version of Policy Manager. If you are using the original version, some things may have changed. To try the new beta, click Switch to BETA.

  1. In ‚ÄčAkamai Control Center‚Äč, go to ‚ėį > CDN > Image and Video Manager.

    Image and Video Manager opens to the Policy Manager page.

  2. Select the correct Contract from the list.

  3. Expand the policy set that was created when you saved your rule.

  4. Open the Actions menu for the default policy and select View/Edit policy on staging.

    The Video Policy Editor appears.

Configure your optimization settings

Configure Image and Video Manager to optimize your videos based on your video quality and breakpoint tolerances. For more information about video optimization settings, see Optimize your videos.

  1. Select a fixed Quality for your videos. You choices range from High to Low. For the purposes of this tutorial, select Medium. This reduces video file size while delivering medium visual quality.

  2. Select 1280x720 pixels as the Derivative Video Resolution. Dervative videos will play at medium resolution.

Save and test your policy

  1. Click Save and Test on Staging.

    You are now ready to test your policy's impact on your actual videos in the staging environment.