w3c / w3c/vc-render-method

Internationalization is broken for card method

Open
#63 1 comment 0 reactions 2 assignees View on GitHub

@ottonomy is already working on this.

Since Aug 16, 2026.

discuss
Dominant language
HTML
Stars
9
Forks
8
Avg merge
14d 42m
Merged PRs (30d)
2

Description

We don't have a good internationalization story for the rendering methods spec at present.

The HTML Rendering Method is fully i18n compliant, as long as we state that the preferred language needs to be sent into the HTML environment.

It might be useful to also have a language tag on the rendering method so a client has an easier time picking between them. This is especially true for the card method, which could be greatly simplified if a language went with each template. Embedding a mixed set of language tags within the template would result in far more complicated renderers and, likely, broken UX. So, either we need to make sure that all human-displayable strings support i18n (the current card spec does not support that), or we need to be able to specify that a specific card is for a specific language. These are things that JSON-LD gave us for free, but since we are using JSON for the card inputs/outputs, we have to create a full i18n story for those objects in order to pass i18n review.

This issue is to track this concern and address it before we get i18n review.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.