---
url: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/integrations/entity-browser'
title: 'Pick images with Entity Browser | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2023-11-06T05:57:41+00:00'
updated: '2026-10-23T14:31:17+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: 'Legacy media browsing with Entity Browser'
tags:
  - 'Connect Drupal features'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-23T14:31:17+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Pick images with Entity Browser'
      description: 'Legacy media browsing with Entity Browser'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2023-11-06T05:57:41+0000'
      dateModified: '2026-10-23T14:31:17+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/integrations/entity-browser'
      articleSection: 'Connect Drupal features'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/hc/documentation/learn-dxpr-builder/integrations/entity-browser'
      description: 'Legacy media browsing with Entity Browser'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Home
            item: 'https://dxpr.com/'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: en
---
[Help Center](/hc)/[Documentation](/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Connect Drupal features](/hc/documentation/learn-dxpr-builder/integrations) # Pick images with Entity Browser.

Legacy media browsing with Entity Browser

 Learn DXPR BuilderManage the siteConnect Drupal features

   ## In this guide

 Related guides

- [Media Library](/hc/documentation/learn-dxpr-builder/integrations/media-library)

Does your site already use the Entity Browser module? Then you can let DXPR Builder open the same browser for every image field, so editors see one picker everywhere. On a new site, use the [Media library](/hc/documentation/learn-dxpr-builder/integrations/media-library) instead: the settings page calls Entity Browser the legacy option.

## Before you start

- The **Entity Browser** module is enabled.
- An entity browser for images exists. You find it at **Entity browsers**(`/admin/config/content/entity_browser`).
- That browser's **Display plugin** is **Modal**.
- Editors have that browser's permission, named "Access *browser name* pages".

DXPR Builder ships a ready-made browser in the hidden **DXPR Builder Media** submodule: "DXPR Builder Image Browser". Hidden modules do not show under **Extend**; a developer enables it with `drush en dxpr_builder_media`.

## Set up

1. Go to **DXPR Studio** > **DXPR Builder** > **General Settings**(`/admin/dxpr_studio/dxpr_builder/settings`).
2. Open the **Media** section.
3. Under **Browser type**, choose the machine name of your browser, for example `dxpr_builder_media_modal`.
4. Click **Save settings**.
5. Edit a page, add an **Image** element and click **Select Image**.

## What you see

Your entity browser opens in the **Media browser**dialog. It has the tabs and buttons you gave it. The DXPR Builder Image Browser has two tabs: **Media Library** to pick an existing image with **Select image**, and **Upload new image** to add one with **Save image**.

|  | Media Library | Entity Browser |
|---|---|---|
| Part of Drupal core | yes | no, contributed module |
| Shown under **Browser type** as | **Media Library** | the browser's machine name |
| **Select video** on video fields | opens the video media type | opens the same browser |
| Setup | enable the module | build a browser, set it to Modal, grant its permission |

## If you don't see your browser

- **Your browser is not listed under Browser type.** The Entity Browser module is off or no browser exists yet. Create one at `/admin/config/content/entity_browser`.
- **The dialog shows "Page not found".** The browser uses a display other than Modal, and DXPR Builder only opens modal browsers. Set its **Display plugin** to **Modal**.
- **The dialog shows "Access denied".** Your role lacks the browser's permission. Grant "Access *browser name* pages" under **People** > **Permissions** (`/admin/people/permissions`).

## What's next?

[Media library, the default image picker](/hc/documentation/learn-dxpr-builder/integrations/media-library) to continue exploring DXPR Builder.