How to Insert MediaValet Assets into WordPress

This article covers how to use the MediaValet WordPress connector to insert assets via CDN links, so any updates made in your DAM are automatically reflected wherever those assets appear in WordPress.

Prerequisites

• The MediaValet WordPress plugin must be installed and enabled in your WordPress environment. If it is not installed, contact your MediaValet administrator or reach out to support@mediavalet.com to get the integration enabled.
• You must have an assigned MediaValet integration license seat. Your DAM administrator manages license assignments.
• Your MediaValet account must have the appropriate category permissions for the assets you want to use.
• Compatible with WordPress 6.x (Gutenberg and Classic editor). WordPress multisite is not supported.

 Add a MediaValet Asset to the Media Library

1. In your WordPress dashboard, navigate to Media > MediaValet CDN.
    

2. Click Select an Asset from MediaValet. If you are not already signed in, you will be prompted to authenticate with your MediaValet credentials.

   (Note, if you get this message:  "You don't currently have access to this app. Please contact your account manager to purchase a subscription", your MediaValet Admin needs to add a seat for Wordpress for you in MediaValet).

   

3. Browse or search for the asset you want to insert. You can navigate categories, use collections, or use the search and advanced search features — the same as in your MediaValet DAM.

   3a. Finding Assets with Smart Image Search

   Smart Image Search (SIS) lets you find images using natural language — no need-to-know exact file names, metadata, or which category they're stored in.
    

   How to use it:
   1. Open the Asset Picker inside your integration (Monday.com, Drupal, or WordPress).

   2. Click the Smart Image Search icon next to the search bar.

   3. Type a description of the image you're looking for (for example, "a woman laughing") and press Enter. 

   

   Once activated, you'll see "Smart Image Search is activated" below the search bar, confirming SIS mode is on.
    

   Reviewing your results:
    

   1. Results appear in the same grid view you're used to, with up to 200 images per search.

   2. You can narrow results using: Category, Collection, File Type, Upload Date, and Status.

   3. The People in Images filter also works with SIS if you're searching for specific people.

    

   Inserting an asset:
    

   Once you find the image you want, select it and insert it into your content the same way you would with a regular search — no extra steps needed.
   Good to know:
    

   1. SIS works with images only (not documents or video).

   2. The more detail you give in your search, the better your results — single words won't work as well as full descriptions.

    

   Note: The asset picker respects your MediaValet permissions. You will only see categories and assets your account is authorized to access.

4. Select your asset and click the + icon "Insert as CDN link" to proceed.

   

5. Choose "Default" if you want to create a new CDN or select an existing CDN link for the asset.
    
6. Optionally configure CDN transformation settings for your link— such as resizing or cropping for images, or resizing and format conversion for videos. For how to apply CDN dynamic transformations, see this article.
    .

7. Click Insert URL to add the asset to your WordPress media library then "Add to Media Library". The asset is now available in your WordPress media library. MediaValet metadata — including the asset title, alt text, and any expiry date — is automatically carried over. 

   Note: Assets are inserted as CDN links, not local file copies. This means they are dynamically connected to MediaValet — if the asset is updated in the DAM, it will automatically update everywhere it has been used on your WordPress site.

Use a MediaValet Asset in a Post or Page

7. Open the post or page where you want to use the asset.

8. In the editor, add an Image or Video block and click Media Library.

   

9. Select your MediaValet asset from the media library, add details on the right if needed and click Select.
    

   

10. Save or publish your post.
     

    Important to note: If you update/modify the file in MediaValet, the changes will also show in Wordpress since CDN links are dynamic by default. If you don't want the asset to update when updated on MediaValet, Select your file under Media Library and unselect the option "Serve dynamically from CDN (auto-updates)".
    

Related Articles

• How to Set Up the MediaValet Integration with WordPress

*Some CDN Dynamic Asset Transformations are part of CDN pricing. For any questions, please reach out to your Account Manager.

For additional help, contact the MediaValet Support team at support@mediavalet.com.