Add componentMetadata with path to component including base_path [#3567767]

Problem/Motivation

componentMetadata.path gives the path relative to the Drupal root. If the Drupal site is not at the root of the host, this is not enough to get full path to the component. It would be missing the base_path().

Example use case: A SDC which provides markup that refers to an image that is included in the SDC. The src attribute would need to include the full path to the image file.

Proposed resolution

Create componentMetadata.fullPath which is like base_path() . componentMetadata.path. Alternatively, create componentMetadata.base_path

Remaining tasks

Decide which to do. Implement.

User interface changes

None.

Introduced terminology

None.

API changes

Addition of componentMetadata.fullPath.

Data model changes

None.

Release notes snippet

Issue fork drupal-3567767

Show commands

Start within a Git clone of the project using the version control instructions.

Add & fetch this issue fork’s repository

Or, if you do not have SSH keys set up on git.drupalcode.org:

Add & fetch this issue fork’s repository

3567767-add-componentmetadata-with changes, plain diff MR !14360
Check out this branch for the first time

Check out existing branch, if you already have it locally

About issue forks

Comments

Comment #1

15 January 2026 at 16:22

liam morland created an issue. See original summary.

Comment #2

15 January 2026 at 17:58

liam morland opened merge request !14360

Comment #3

liam morland

English

Ontario, CA 🇨🇦

commented 15 January 2026 at 17:58

Issue summary:	View changes
Status:	Active	» Needs review

Comment #4

15 January 2026 at 17:58

Version:

11.x-dev

» main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Comment #5

smustgrave commented 9 February 2026 at 15:34

Issue tags:

+Needs subsystem maintainer review

Comment #6

pdureau commented 21 March 2026 at 21:07

Thanks Liam for your contribution.

Because you sue base_path(), I guess the distinction is not between path and fullPath but about server and web path.

Looking at Core and some contrib themes, it seems componentMetadata.path is rarely used:

26 times total on 1184 components
in 6 themes (mercury, nttdata_theme, umami, drupal_cms_olivero, governor, etc...) on 40

The usage is split between:

Server side path: {{ include (componentMetadata.path ~ '/images/arrow.svg') }}, {{ source(componentMetadata.path ~ '/icons/' ~ icon|default('knife') ~ '.svg') }}...
Web side path : <img src="{{ componentMetadata.path ~ '/' ~ media.src }}">...

If I understand well, componentMetadata.path is the good solution for server side path, but works on Web side (href, src...) only if base_path() === "/". That's it?