diff --git a/docs/extensions/location.mdx b/docs/extensions/location.mdx index d35ba767f3..62af53a381 100644 --- a/docs/extensions/location.mdx +++ b/docs/extensions/location.mdx @@ -23,6 +23,9 @@ atomWithLocation(options): PrimitiveAtom `atomWithLocation` creates a new atom that links to `window.location`. +Typically, you should only instantiate `atomWithLocation` once per application. This is because changes made to one instance might not be reflected in others. +As this atom is designed to synchronize with the `window.location` object, using multiple instances can lead to unpredictable behavior. + ### Parameters **options** (optional): an object of options to customize the behavior of the atom