---
title: "Integrate Acquia DAM with LinkIt"
date: "2026-04-15T08:32:10+00:00"
summary:
image:
type: "page"
url: "/acquia-dam/integrate-acquia-dam-linkit"
id: "f341b7f8-2742-42e0-a0df-1bbf4c75d9a8"
---

Link Acquia DAM assets directly in rich text fields through the LinkIt plugin in CKEditor. When this integration is configured, content authors can use the Link option in CKEditor to search and select Acquia DAM media entities and insert links to them in body fields, long text fields, and other WYSIWYG components.

This guide describes how to configure LinkIt profiles and text formats so that CKEditor can use Acquia DAM media types through the LinkIt plugin.

Prerequisites
-------------

Before you begin, make sure that:

*   The Acquia DAM module is active and configured.
*   The LinkIt module is enabled and functional.
*   Acquia DAM media types and fields are configured as described in the main [Acquia DAM integration](/campaign-studio/acquia-dam-integration "Acquia DAM integration") page.
*   You have a user role with permission to:
    *   Administer text formats and editors.
    *   Administer LinkIt profiles.
    *   Access Acquia DAM media types.

Configure a LinkIt profile for Acquia DAM media
-----------------------------------------------

### Step 1: Create a LinkIt profile

1.  In the admin toolbar, go to **Administration** → **Configuration** → **Content authoring** → **Linkit**.
2.  Click **\+ Add profile**.
3.  Enter a **Profile name** and **Description** to identify this profile as the one that supports Acquia DAM media links.
4.  Click **Save and manage matchers**.

### Step 2: Add a media matcher for Acquia DAM

1.  On the profile page, select **Add matcher**.
2.  Select **Media** as the matcher type, then click **Save and continue**.
3.  On the media matcher configuration page:
    1.  Under Bundle restrictions, select the Acquia DAM media bundles you want to link.  
        Such as:
        *   Acquia DAM image
        *   Acquia DAM video
        *   Any custom Acquia DAM media type
    2.  Under URL substitution, select the appropriate substitution plugin for media entities.  
        This controls the URL format LinkIt inserts for Acquia DAM media, such as entity URL, canonical path, or a custom substitution plugin that your site defines.
    3.  Configure additional field or label settings to improve the search experience.
        
        ![Acquia-DAM_link-matcher](https://acquia.widen.net/content/x8yzovgfvn/web/5291e_Acquia-DAM-integration-linkit-profile-matchers.png?v=60f2f6e9-b52a-4c75-a89d-82748f984aae)
        
4.  Click **Save changes**.

Your LinkIt profile now includes a matcher that allows LinkIt to search and link Acquia DAM media.

Configure text formats to link Acquia DAM media
-----------------------------------------------

You must configure each text format that enables authors to create links to Acquia DAM media through LinkIt. Typical formats include basic HTML, full HTML, or any custom text format in use.

### Step 1: Open text formats and editors

1.  In the admin toolbar, go to **Administration** → **Configuration** → **Content authoring** → **Text formats and editors**.
2.  Review the list of text formats, such as plain text, basic HTML, and full HTML.
    

### Step 2: Configure a text format for LinkIt

Repeat these steps for each text format that should support links to Acquia DAM media.

1.  On the _Text formats and editors_ page, locate the desired text format, such as Full HTML.
2.  In the Operations column, select **Configure**.
3.  On the configuration page, confirm that Editor is set to CKEditor (CKEditor or CKEditor 5, depending on your Drupal version).
4.  In the Toolbar configuration section, ensure that the Link button is present in the Active toolbar:
    *   If necessary, drag the link from _Available buttons_ into the _Active toolbar_.
        
        ![Acquia-DAM_linkittoolbar](https://acquia.widen.net/content/dovoqt1bek/web/4d204_Acquia-DAM-integration-LinkIt-toolbar.png?v=d9dd7fac-98ea-4d85-b0d9-13ecb85eefcf)
        
5.  In the Enabled filters section, check the _Linkit URL converter filter_.
6.  Go to the CKEditor 5 plugin settings section.
7.  Find the Linkit subsection.
8.  From the Linkit profile list, choose the LinkIt profile that you configured for Acquia DAM media.
9.  Go to the Filter settings section.
10.  Find the Linkit URL converter subsection.
11.  Under Media entity URL substitution, select the appropriate substitution plugin that should apply to Acquia DAM media entities.
12.  Click **Save configuration**.

Repeat these steps for any additional text formats, such as basic HTML, that should allow links to Acquia DAM media.

Use LinkIt with Acquia DAM in CKEditor
--------------------------------------

After configuration, authors can create links to Acquia DAM media directly from CKEditor:

1.  Edit content that uses a text field with CKEditor and a text format configured for LinkIt.
2.  Select the text that should become a link.
3.  Select the link in the toolbar.
4.  In the LinkIt dialog, search for Acquia DAM media by name or other metadata.
5.  Select the desired media entity from the results.
6.  Apply the link and save the content.

On display, the link uses the URL format defined by your LinkIt profile and the configured substitution plugin.