Skip to content

Conversation

@PatElderShop
Copy link

@PatElderShop PatElderShop commented Oct 21, 2025

Add documentation about uiLocales parameter limitation with third-party identity providers.

When using third-party identity providers with headless storefronts, the uiLocales parameter is not passed to the identity provider during authentication callbacks. This means the third-party login interface may not automatically reflect the customer's preferred language setting.

This change addresses a documentation gap identified by the Developer Support team.

Context

  • Why: Developers were not aware that the uiLocales parameter doesn't get passed to third-party identity providers, leading to confusion when the third-party login UI doesn't reflect the expected language
  • Problem it solves: Clarifies expected behavior and helps developers understand why language settings may not propagate to third-party auth providers
  • Related to: Developer Support feedback regarding missing documentation about this limitation
  • Impact: This is a documentation-only change that helps developers better understand the authentication flow behavior
  • Risk: No functional changes, only documentation updates to existing JSDoc comments

Testing

This is a documentation-only change. The changes can be verified by:

  1. Running the docs generation process
  2. Checking that the JSDoc comments appear correctly in the generated documentation
  3. Verifying TypeScript types still compile correctly
    this page should have the listed change
    https://shopify-dev.shop.dev/docs/api/hydrogen/latest/utilities/createcustomeraccountclient (check for uiLocales note)

…roviders

- Document that uiLocales parameter is not passed to third-party identity providers
- Add JSDoc comments to LoginOptions type properties
- Update login method documentation to clarify the limitation

This addresses a documentation gap identified by the Developer Support team where
the uiLocales parameter behavior with third-party providers was not documented.
@PatElderShop PatElderShop requested a review from a team as a code owner October 21, 2025 01:10
@github-actions
Copy link
Contributor

We detected some changes in packages/*/package.json or packages/*/src, and there are no updates in the .changeset.
If the changes are user-facing and should cause a version bump, run npm run changeset add to track your changes and include them in the next release CHANGELOG.
If you are making simple updates to examples or documentation, you do not need to add a changeset.

@shopify
Copy link
Contributor

shopify bot commented Oct 21, 2025

Oxygen deployed a preview of your docs/uiLocales-third-party-limitation branch. Details:

Storefront Status Preview link Deployment details Last update (UTC)
Skeleton (skeleton.hydrogen.shop) ✅ Successful (Logs) Preview deployment Inspect deployment October 22, 202510:22 PM

Learn more about Hydrogen's GitHub integration.

Copy link
Contributor

@juanpprieto juanpprieto left a comment

Choose a reason for hiding this comment

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

Thank you!

- Reword uiLocales note to lead with user impact first
- Use more conversational language ('might not' vs 'may not', 'That's because')
- Apply consistent wording across both JSDoc locations

Based on feedback from shopify-dev PR review
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants