mdn / mdn/content

Native manifests new location (once XDG base dirs layout is adopted) is either outdated or unclear

Open
#42,996 4 comments 0 reactions 0 assignees View on GitHub
Content:WebExt on hold
Dominant language
Markdown
Stars
11k
Forks
23.2k
Avg merge
2d 9h
Merged PRs (30d)
331

Description

### MDN URL

https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests

### What specific section or headline is this issue about?

Manifest Location / Linux

### What information was incorrect, unhelpful, or incomplete?

After migration to XDG Base Dirs specification for ones' Firefox instance, it's undocumented and a bit unclear where native-messaging configuration should go. I used to use `~/.mozilla/native-messaging-hosts/.json` but I guess the equivalent for XDG Base Dirs should either be documented or implemented if alternative XDG-compatible locations are not yet there.

### What did you expect to see?

A list of XDG Base Dirs compatible per-user paths.

### Do you have any supporting links, references, or citations?

https://specifications.freedesktop.org/basedir/latest/

### Do you have anything more you want to share?

I've currently tried `~/.local/share/mozilla/native-messaging-hosts` and it's not working.

### MDN metadata

Page report details

* Folder: `en-us/mozilla/add-ons/webextensions/native_manifests`
* MDN URL: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests
* GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/mozilla/add-ons/webextensions/native_manifests/index.md
* Last commit: https://github.com/mdn/content/commit/09109b6f9444d22215ba330ec1e64e73980b2a6c
* Document last modified: 2025-07-17T07:48:12.000Z

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.