From 5a9ac080305c5ae388e46ff301c8c36fbd685882 Mon Sep 17 00:00:00 2001
From: Dmitri Zagidulin <dzagidulin@gmail.com>
Date: Tue, 6 Oct 2026 10:54:01 -0400
Subject: [PATCH 1/3] Add a Selecting on Language section, 'targetLanguage'
 property.

Signed-off-by: Dmitri Zagidulin <dzagidulin@gmail.com>
---
 index.html | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 07f6141..81912b2 100644
--- a/index.html
+++ b/index.html
@@ -292,7 +292,7 @@ <h3>The `renderMethod` Property</h3>
 
         <p>
 The `renderMethod` property is a reserved extension point in the
-[[[VC-DATA-MODEL-2.1]]] specification . An [=issuer=] can utilize this property
+[[[VC-DATA-MODEL-2.1]]] specification. An [=issuer=] can utilize this property
 in a [=verifiable credential=] to express one or more preferred render methods.
         </p>
 
@@ -310,6 +310,20 @@ <h3>The `renderMethod` Property</h3>
         </dl>
       </section>
 
+      <section>
+        <h4>Localization: Selecting on Language and Locale</h4>
+
+        <p>
+One of the core use cases for this specification is the ability to present a
+different rendering payload based on the preferred language or locale of the
+user. This extends beyond the value-level localization offered by the core
+[[VC-DATA-MODEL#internationalization-considerations]] specification, and beyond
+translating field labels. Clients displaying or rendering VCs must be able to
+select arbitrary layouts, styling or full pre-rendered payloads based on the
+user's language and locale preferences.
+        </p>
+      </section>
+
       <section>
         <h4>SuiteRenderMethod</h4>
 
@@ -370,6 +384,14 @@ <h4>SuiteRenderMethod</h4>
 than `name` of when the particular rendering might be useful.
               </td>
             </tr>
+            <tr>
+              <td>targetLanguage</td>
+              <td>
+An OPTIONAL [=string=] that designates a language range this render method is
+meant to support (see the<a href="https://www.w3.org/TR/international-specs/#lang-matching">Matching
+language and language tags</a> section for more details).
+              </td>
+            </tr>
             <tr>
               <td>renderProperty</td>
               <td>

From 34b599a42fe4a4126808787bd864bc711e2ad802 Mon Sep 17 00:00:00 2001
From: Dmitri Zagidulin <dzagidulin@gmail.com>
Date: Tue, 6 Oct 2026 12:04:32 -0400
Subject: [PATCH 2/3] Use schema.org's 'inLanguage' instead of
 'targetLanguage'.

Signed-off-by: Dmitri Zagidulin <dzagidulin@gmail.com>
---
 index.html | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/index.html b/index.html
index 81912b2..6d499b7 100644
--- a/index.html
+++ b/index.html
@@ -385,10 +385,11 @@ <h4>SuiteRenderMethod</h4>
               </td>
             </tr>
             <tr>
-              <td>targetLanguage</td>
+              <td>inLanguage</td>
               <td>
-An OPTIONAL [=string=] that designates a language range this render method is
-meant to support (see the<a href="https://www.w3.org/TR/international-specs/#lang-matching">Matching
+An OPTIONAL [=string=] that designates a language range (based on
+<a href="https://schema.org/inLanguage">schema.org/inLanguage</a>) this render
+method is meant to support (see the <a href="https://www.w3.org/TR/international-specs/#lang-matching">Matching
 language and language tags</a> section for more details).
               </td>
             </tr>

From 43668788c2ee23c31ca3003080300598b96d75de Mon Sep 17 00:00:00 2001
From: Dmitri Zagidulin <dzagidulin@gmail.com>
Date: Tue, 13 Oct 2026 10:57:55 -0400
Subject: [PATCH 3/3] Add language-selection example to the Localization
 section.

Signed-off-by: Dmitri Zagidulin <dzagidulin@gmail.com>
---
 index.html | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/index.html b/index.html
index 6d499b7..939f04b 100644
--- a/index.html
+++ b/index.html
@@ -322,6 +322,39 @@ <h4>Localization: Selecting on Language and Locale</h4>
 select arbitrary layouts, styling or full pre-rendered payloads based on the
 user's language and locale preferences.
         </p>
+
+        <p>
+In the example below, the `renderMethod` property contains an array of two
+`static` render method objects, each providing a pre-rendered PNG image of
+the credential. The client selects the one whose `inLanguage` value best
+matches the user's language preference.
+        </p>
+
+        <pre class="example nohighlight"
+              title="Selecting a render method by language">
+{
+<span class="comment">...</span>
+"renderMethod": [
+  {
+    "type": "SuiteRenderMethod",
+    "renderSuite": "static",
+    "inLanguage": "en",
+    "mediaType": "image/png",
+    "name": "Credential image",
+    "payload": "data:image/png;base64,iVBORw0KGgo...AAAElFTkSuQmCC"
+  },
+  {
+    "type": "SuiteRenderMethod",
+    "renderSuite": "static",
+    "inLanguage": "es",
+    "mediaType": "image/png",
+    "name": "Imagen de la credencial",
+    "payload": "data:image/png;base64,iVBORw0KGgo...AAAElFTkSuQmCC"
+  }
+]
+<span class="comment">...</span>
+}
+        </pre>
       </section>
 
       <section>