From 9e5fe33b9cd527dec6e70fe10e0e81ab8ca23b25 Mon Sep 17 00:00:00 2001
From: yuki0418 <keryuuki0418@gmail.com>
Date: Wed, 1 Oct 2025 07:58:10 +0900
Subject: [PATCH 1/4] fix: update  error message to clarify usage with radio
 inputs

---
 .changeset/slow-nails-push.md                               | 5 +++++
 documentation/docs/03-template-syntax/12-bind.md            | 4 +++-
 .../src/compiler/phases/2-analyze/visitors/BindDirective.js | 6 +++++-
 .../validator/samples/binding-input-checked/errors.json     | 2 +-
 4 files changed, 14 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/slow-nails-push.md

diff --git a/.changeset/slow-nails-push.md b/.changeset/slow-nails-push.md
new file mode 100644
index 000000000000..8dedf35593eb
--- /dev/null
+++ b/.changeset/slow-nails-push.md
@@ -0,0 +1,5 @@
+---
+'svelte': patch
+---
+
+fix: update `bind:checked` error message to clarify usage with radio inputs
diff --git a/documentation/docs/03-template-syntax/12-bind.md b/documentation/docs/03-template-syntax/12-bind.md
index de57815687dc..50e543be666b 100644
--- a/documentation/docs/03-template-syntax/12-bind.md
+++ b/documentation/docs/03-template-syntax/12-bind.md
@@ -95,7 +95,7 @@ Since 5.6.0, if an `<input>` has a `defaultValue` and is part of a form, it will
 
 ## `<input bind:checked>`
 
-Checkbox and radio inputs can be bound with `bind:checked`:
+Checkbox can be bound with `bind:checked`:
 
 ```svelte
 <label>
@@ -117,6 +117,8 @@ Since 5.6.0, if an `<input>` has a `defaultChecked` attribute and is part of a f
 </form>
 ```
 
+> [!NOTE] Use `group:bind` for radio inputs instead of `bind:checked`.
+
 ## `<input bind:indeterminate>`
 
 Checkboxes can be in an [indeterminate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/indeterminate) state, independently of whether they are checked or unchecked:
diff --git a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
index 9f02e7fa5a02..497c4c226de5 100644
--- a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
+++ b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
@@ -67,7 +67,11 @@ export function BindDirective(node, context) {
 					}
 				} else {
 					if (node.name === 'checked' && type?.value[0].data !== 'checkbox') {
-						e.bind_invalid_target(node, node.name, '<input type="checkbox">');
+						e.bind_invalid_target(
+							node,
+							node.name,
+							`<input type="checkbox"> - for <input type="radio">, use 'group' binding`
+						);
 					}
 
 					if (node.name === 'files' && type?.value[0].data !== 'file') {
diff --git a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
index 574b25e06fa5..ec6437030f5c 100644
--- a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:checked` can only be used with <input type=\"checkbox\">",
+		"message": "`bind:checked` can only be used with <input type=\"checkbox\"> - for <input type=\"radio\">, use 'group' binding",
 		"start": {
 			"line": 5,
 			"column": 7

From 23ecd3db29c86c597f9705d43b343a64173c3bac Mon Sep 17 00:00:00 2001
From: yuki0418 <keryuuki0418@gmail.com>
Date: Wed, 1 Oct 2025 09:24:17 +0900
Subject: [PATCH 2/4] show an extra bind checked error when a radio type

---
 documentation/docs/03-template-syntax/12-bind.md   |  2 +-
 .../phases/2-analyze/visitors/BindDirective.js     |  2 +-
 .../samples/binding-input-checked/errors.json      |  2 +-
 .../binding-radio-input-checked/errors.json        | 14 ++++++++++++++
 .../binding-radio-input-checked/input.svelte       |  5 +++++
 5 files changed, 22 insertions(+), 3 deletions(-)
 create mode 100644 packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
 create mode 100644 packages/svelte/tests/validator/samples/binding-radio-input-checked/input.svelte

diff --git a/documentation/docs/03-template-syntax/12-bind.md b/documentation/docs/03-template-syntax/12-bind.md
index 50e543be666b..91bd59665b74 100644
--- a/documentation/docs/03-template-syntax/12-bind.md
+++ b/documentation/docs/03-template-syntax/12-bind.md
@@ -95,7 +95,7 @@ Since 5.6.0, if an `<input>` has a `defaultValue` and is part of a form, it will
 
 ## `<input bind:checked>`
 
-Checkbox can be bound with `bind:checked`:
+Checkbox inputs can be bound with `bind:checked`:
 
 ```svelte
 <label>
diff --git a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
index 497c4c226de5..47aa79c77d69 100644
--- a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
+++ b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
@@ -70,7 +70,7 @@ export function BindDirective(node, context) {
 						e.bind_invalid_target(
 							node,
 							node.name,
-							`<input type="checkbox"> - for <input type="radio">, use 'group' binding`
+							`<input type="checkbox">${type?.value[0].data === 'radio' ? ` — for <input type="radio">, use 'group' binding` : ''}`
 						);
 					}
 
diff --git a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
index ec6437030f5c..574b25e06fa5 100644
--- a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:checked` can only be used with <input type=\"checkbox\"> - for <input type=\"radio\">, use 'group' binding",
+		"message": "`bind:checked` can only be used with <input type=\"checkbox\">",
 		"start": {
 			"line": 5,
 			"column": 7
diff --git a/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json b/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
new file mode 100644
index 000000000000..53629ce30064
--- /dev/null
+++ b/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
@@ -0,0 +1,14 @@
+[
+	{
+		"code": "bind_invalid_target",
+		"message": "`bind:checked` can only be used with <input type=\"checkbox\"> — for <input type=\"radio\">, use 'group' binding",
+		"start": {
+			"line": 5,
+			"column": 20
+		},
+		"end": {
+			"line": 5,
+			"column": 38
+		}
+	}
+]
diff --git a/packages/svelte/tests/validator/samples/binding-radio-input-checked/input.svelte b/packages/svelte/tests/validator/samples/binding-radio-input-checked/input.svelte
new file mode 100644
index 000000000000..67e7b77a3ae9
--- /dev/null
+++ b/packages/svelte/tests/validator/samples/binding-radio-input-checked/input.svelte
@@ -0,0 +1,5 @@
+<script>
+	let foo;
+</script>
+
+<input type="radio" bind:checked={foo}>
\ No newline at end of file

From d2e2021e3009ad4878c8f2d537733f745e3d3031 Mon Sep 17 00:00:00 2001
From: Rich Harris <rich.harris@vercel.com>
Date: Wed, 1 Oct 2025 11:37:03 -0400
Subject: [PATCH 3/4] typo

---
 documentation/docs/03-template-syntax/12-bind.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/documentation/docs/03-template-syntax/12-bind.md b/documentation/docs/03-template-syntax/12-bind.md
index 91bd59665b74..c21ed3591930 100644
--- a/documentation/docs/03-template-syntax/12-bind.md
+++ b/documentation/docs/03-template-syntax/12-bind.md
@@ -117,7 +117,7 @@ Since 5.6.0, if an `<input>` has a `defaultChecked` attribute and is part of a f
 </form>
 ```
 
-> [!NOTE] Use `group:bind` for radio inputs instead of `bind:checked`.
+> [!NOTE] Use `bind:group` for radio inputs instead of `bind:checked`.
 
 ## `<input bind:indeterminate>`
 

From 926f9a571e8b0a43663e699c9048a7fbf8c67e7f Mon Sep 17 00:00:00 2001
From: Rich Harris <rich.harris@vercel.com>
Date: Wed, 1 Oct 2025 11:43:30 -0400
Subject: [PATCH 4/4] replace 'group' binding with , drive-by fix some other
 messages

---
 .../compiler/phases/2-analyze/visitors/BindDirective.js   | 8 ++++----
 .../samples/dynamic-element-binding-invalid/_config.js    | 2 +-
 .../validator/samples/binding-dimensions-svg/errors.json  | 2 +-
 .../validator/samples/binding-input-checked/errors.json   | 2 +-
 .../samples/binding-invalid-on-element-2/errors.json      | 2 +-
 .../samples/binding-invalid-on-element/errors.json        | 2 +-
 .../samples/binding-radio-input-checked/errors.json       | 2 +-
 7 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
index 47aa79c77d69..995d251a2ee2 100644
--- a/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
+++ b/packages/svelte/src/compiler/phases/2-analyze/visitors/BindDirective.js
@@ -33,7 +33,7 @@ export function BindDirective(node, context) {
 				e.bind_invalid_target(
 					node,
 					node.name,
-					property.valid_elements.map((valid_element) => `<${valid_element}>`).join(', ')
+					property.valid_elements.map((valid_element) => `\`<${valid_element}>\``).join(', ')
 				);
 			}
 
@@ -70,12 +70,12 @@ export function BindDirective(node, context) {
 						e.bind_invalid_target(
 							node,
 							node.name,
-							`<input type="checkbox">${type?.value[0].data === 'radio' ? ` — for <input type="radio">, use 'group' binding` : ''}`
+							`\`<input type="checkbox">\`${type?.value[0].data === 'radio' ? ` — for \`<input type="radio">\`, use \`bind:group\`` : ''}`
 						);
 					}
 
 					if (node.name === 'files' && type?.value[0].data !== 'file') {
-						e.bind_invalid_target(node, node.name, '<input type="file">');
+						e.bind_invalid_target(node, node.name, '`<input type="file">`');
 					}
 				}
 			}
@@ -98,7 +98,7 @@ export function BindDirective(node, context) {
 				e.bind_invalid_target(
 					node,
 					node.name,
-					`non-<svg> elements. Use 'clientWidth' for <svg> instead`
+					`non-\`<svg>\` elements. Use \`bind:clientWidth\` for \`<svg>\` instead`
 				);
 			}
 
diff --git a/packages/svelte/tests/compiler-errors/samples/dynamic-element-binding-invalid/_config.js b/packages/svelte/tests/compiler-errors/samples/dynamic-element-binding-invalid/_config.js
index 4bb3edc27b1b..25b082776573 100644
--- a/packages/svelte/tests/compiler-errors/samples/dynamic-element-binding-invalid/_config.js
+++ b/packages/svelte/tests/compiler-errors/samples/dynamic-element-binding-invalid/_config.js
@@ -3,6 +3,6 @@ import { test } from '../../test';
 export default test({
 	error: {
 		code: 'bind_invalid_target',
-		message: '`bind:value` can only be used with <input>, <textarea>, <select>'
+		message: '`bind:value` can only be used with `<input>`, `<textarea>`, `<select>`'
 	}
 });
diff --git a/packages/svelte/tests/validator/samples/binding-dimensions-svg/errors.json b/packages/svelte/tests/validator/samples/binding-dimensions-svg/errors.json
index 4d3819453c81..61e6ca63558c 100644
--- a/packages/svelte/tests/validator/samples/binding-dimensions-svg/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-dimensions-svg/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:offsetWidth` can only be used with non-<svg> elements. Use 'clientWidth' for <svg> instead",
+		"message": "`bind:offsetWidth` can only be used with non-`<svg>` elements. Use `bind:clientWidth` for `<svg>` instead",
 		"start": {
 			"line": 5,
 			"column": 5
diff --git a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
index 574b25e06fa5..d7e8e48c9555 100644
--- a/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-input-checked/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:checked` can only be used with <input type=\"checkbox\">",
+		"message": "`bind:checked` can only be used with `<input type=\"checkbox\">`",
 		"start": {
 			"line": 5,
 			"column": 7
diff --git a/packages/svelte/tests/validator/samples/binding-invalid-on-element-2/errors.json b/packages/svelte/tests/validator/samples/binding-invalid-on-element-2/errors.json
index 92111a4ec201..19d0cd0ce1db 100644
--- a/packages/svelte/tests/validator/samples/binding-invalid-on-element-2/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-invalid-on-element-2/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:open` can only be used with <details>",
+		"message": "`bind:open` can only be used with `<details>`",
 		"start": {
 			"line": 5,
 			"column": 5
diff --git a/packages/svelte/tests/validator/samples/binding-invalid-on-element/errors.json b/packages/svelte/tests/validator/samples/binding-invalid-on-element/errors.json
index 6626afc1d024..781a8301ea70 100644
--- a/packages/svelte/tests/validator/samples/binding-invalid-on-element/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-invalid-on-element/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:value` can only be used with <input>, <textarea>, <select>",
+		"message": "`bind:value` can only be used with `<input>`, `<textarea>`, `<select>`",
 		"start": {
 			"line": 5,
 			"column": 5
diff --git a/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json b/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
index 53629ce30064..beb46affc526 100644
--- a/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
+++ b/packages/svelte/tests/validator/samples/binding-radio-input-checked/errors.json
@@ -1,7 +1,7 @@
 [
 	{
 		"code": "bind_invalid_target",
-		"message": "`bind:checked` can only be used with <input type=\"checkbox\"> — for <input type=\"radio\">, use 'group' binding",
+		"message": "`bind:checked` can only be used with `<input type=\"checkbox\">` — for `<input type=\"radio\">`, use `bind:group`",
 		"start": {
 			"line": 5,
 			"column": 20