Skip to content

Remove shopUser from documented AppMetafieldEntryTarget types - #4601

Closed
amertkara wants to merge 1 commit into
Shopify:2026-07from
amertkara:mk/remove-shopuser-metafield-docs
Closed

Remove shopUser from documented AppMetafieldEntryTarget types#4601
amertkara wants to merge 1 commit into
Shopify:2026-07from
amertkara:mk/remove-shopuser-metafield-docs

Conversation

@amertkara

Copy link
Copy Markdown

Resolves https://github.com/shop/issues-checkout/issues/145

Summary

  • Removes 'shopUser' from the AppMetafieldEntryTarget.type union in the checkout surface standard.ts, and drops its JSDoc bullet.
  • Shop User metafields were never released publicly and there is no intention to release them (privacy concerns). Access has already been revoked, and the merchant-facing handling code was previously removed from checkout-web in shop/world.
  • Because the generated API reference renders the type union itself, the value is currently published on shopify.dev (e.g. /docs/api/checkout-ui-extensions/2025-07/apis/metafields), which led partners to attempt using an unsupported capability and caused repeat incidents (see issue).
  • The static configuration page (configuration#metafields) was already cleaned up separately; this PR covers the remaining generated API reference.
  • Runtime behavior is unchanged — this only narrows the published/documented type.

Tophat

  1. Confirm no remaining shopUser references in the checkout surface: grep -rn \"shopUser\" packages/ui-extensions/src → no results.
  2. Regenerate the checkout API reference docs and verify shopUser no longer appears in the AppMetafieldEntryTarget type values.

Shop User metafields were never released publicly and there is no
intention to release them due to privacy concerns. The value was still
present in the public AppMetafieldEntryTarget type union, so the
generated API reference on shopify.dev documented it as a supported
metafield target, leading partners to attempt using an unsupported
capability (repeat incidents).

This removes 'shopUser' from the type union and its JSDoc bullet so it
no longer appears in the generated reference docs. Runtime behavior is
unchanged.

Resolves shop/issues-checkout#145

Assisted-By: devx/55c486ec-5add-4a66-8725-1eb7879f69bf
@amertkara
amertkara marked this pull request as ready for review July 28, 2026 19:55
@amertkara
amertkara marked this pull request as draft July 28, 2026 19:55
@amertkara

Copy link
Copy Markdown
Author

Closing in favor of fixing this at the source: the checkout-web copy in shop/world is the source of truth for these docs (per https://github.com/shop/issues-checkout/issues/145). The change will land in this repo through the usual ui-extensions docs sync.

@amertkara amertkara closed this Jul 28, 2026
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.

1 participant