Skip to content

docs: recommend subdirectory for userData to avoid Chromium conflicts#50563

Merged
ckerr merged 1 commit intoelectron:mainfrom
lilianakatrina684-a11y:docs/recommend-userdata-subdirectory
Apr 1, 2026
Merged

docs: recommend subdirectory for userData to avoid Chromium conflicts#50563
ckerr merged 1 commit intoelectron:mainfrom
lilianakatrina684-a11y:docs/recommend-userdata-subdirectory

Conversation

@lilianakatrina684-a11y
Copy link
Copy Markdown
Contributor

Description of Change

  • add a recommendation in the app.getPath('userData') documentation to store app-specific files within a subdirectory of userData rather than directly in its root
  • this avoids naming conflicts with Chromium's own subdirectories (Cache, GPUCache, Local Storage, etc.) that can cause unexpected behavior

Fixes #45414

Checklist

Release Notes

Notes: no-notes

Fixes electron#45414

Storing files directly in the userData root can cause naming conflicts
with Chromium's own subdirectories (Cache, GPUCache, Local Storage, etc.).
Added a recommendation to use a subdirectory such as
path.join(app.getPath('userData'), 'my-app-data') instead.

Notes: no-notes
@electron-cation electron-cation bot added documentation 📓 semver/patch backwards-compatible bug fixes new-pr 🌱 PR opened recently and removed new-pr 🌱 PR opened recently labels Mar 29, 2026
@codebytere codebytere requested a review from nikwen March 31, 2026 10:16
Copy link
Copy Markdown
Member

@ckerr ckerr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@ckerr ckerr added the target/42-x-y PR should also be added to the "42-x-y" branch. label Apr 1, 2026
@ckerr ckerr merged commit 7c1a6f7 into electron:main Apr 1, 2026
47 checks passed
@welcome
Copy link
Copy Markdown

welcome bot commented Apr 1, 2026

Congrats on merging your first pull request! 🎉🎉🎉

@release-clerk
Copy link
Copy Markdown

release-clerk bot commented Apr 1, 2026

No Release Notes

@trop
Copy link
Copy Markdown
Contributor

trop bot commented Apr 1, 2026

I have automatically backported this PR to "42-x-y", please check out #50625

@trop trop bot added in-flight/42-x-y merged/42-x-y PR was merged to the "42-x-y" branch. and removed target/42-x-y PR should also be added to the "42-x-y" branch. in-flight/42-x-y labels Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation 📓 merged/42-x-y PR was merged to the "42-x-y" branch. semver/patch backwards-compatible bug fixes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Recommend to store app-specific files in subdirectory of userData

3 participants