When to use it

Use CountryRedirect when the storefront serves multiple country-specific stores and you want to suggest visitors switch to their local version. It detects a mismatch between the visitor's country and the current store, then shows a dismissible banner.

Composition notes

CountryRedirect is a self-contained banner:

• detectedCountry and currentCountry are objects with code, name, and optional flag. The banner only shows if they differ.
• redirectUrl is where the accept button navigates.
• onAccept and onDismiss are optional callbacks for analytics or custom behavior.
• persistKey controls the localStorage key for dismissal persistence. Set to false to disable persistence.
• labels lets you customize the message, accept, and dismiss button text.

Behavior and theming guidance

The banner renders nothing if countries match or if the visitor previously dismissed it (checked via localStorage). On accept, it navigates to redirectUrl. On dismiss, it hides and persists the dismissal.

Keep the message short and the country names localized. The banner should feel helpful, not intrusive.