Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Import map

Security covered Under active development 43 sites

This module adds an import map to your website, enabling JavaScript imports without specifying full file paths. It automatically generates the necessary import map script, allowing you to import local JavaScript files using simple names. You can also configure modules to be preloaded by the browser for faster loading.

This module allows you to add an import map to your website.
This can be used to allow JS imports without having to specify the full path to the JS file.

(There is a discussion about adding this to Drupal core: #3398525: Add an API for importmaps)

For example, if you have this in your libraries.yml file:

foo:
  js:
    js/foo.js: { attributes: { data-importmap-name: 'foo' } }

It will generate this import map:

<script type="importmap">
{"imports":{"foo":"\/modules\/custom\/foo\/js\/foo.js?s3pik6"}}
</script>

And you can then use import { foo } from "foo"; in your JS to import this file.
(Note that JS scripts that use import need to have the type="module" attribute.)

You do not have to attach libraries that are in the import map, they will be downloaded automatically by the browser when using import.

Preloading modules

You can also preload JS modules like this:

foo:
  js:
    js/foo.js: { attributes: { data-importmap-name: 'foo', data-importmap-preload: true } }

This will make the browser preload the JS module so it can already be available when executing the import.

Drupal 10–11

Ask your assistant about Import map

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
5
Tracked since
Nov 2023
Latest release
1 year ago
Releases (12 mo)
0 ▼ from 2
Maintenance
Slowing

Release Timeline

Releases

Version Type Core PHP Release date
1.0.1 Stable 10–11 Jun 4, 2025
1.0.0 Stable 10–11 Mar 24, 2025
1.0.0-alpha2 Pre-release 10–11 Sep 9, 2024
1.0.0-alpha1 Pre-release 10 Nov 6, 2023
1.x-dev Dev 10–11 Nov 6, 2023