From a3a6f5bf32fc5fffaa0d2cea0cd3cfabd94d8169 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 03:49:50 +0200
Subject: [PATCH 01/16] fix: use plain words in the answer field, rating, date
 and file settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../js/components/Factory/Main/ConfigureDate.vue   |  6 +++---
 .../js/components/Factory/Main/ConfigureFile.vue   | 13 ++++++-------
 .../js/components/Factory/Main/ConfigureInput.vue  | 12 ++++++++----
 .../js/components/Factory/Main/ConfigureRange.vue  | 14 ++++++--------
 .../components/Factory/Main/ConfigureTextarea.vue  |  8 ++++----
 resources/js/components/FieldLabels.test.ts        |  2 +-
 6 files changed, 28 insertions(+), 27 deletions(-)

diff --git a/resources/js/components/Factory/Main/ConfigureDate.vue b/resources/js/components/Factory/Main/ConfigureDate.vue
index e95297a6..fe9e008f 100644
--- a/resources/js/components/Factory/Main/ConfigureDate.vue
+++ b/resources/js/components/Factory/Main/ConfigureDate.vue
@@ -1,15 +1,15 @@
 <template>
   <div>
     <div class="mb-4">
-      <D9Label id="date-min" label="Min Date" />
+      <D9Label id="date-min" label="Min date" />
       <D9Input id="date-min" type="date" block v-model="minDate" />
     </div>
     <div class="mb-4">
-      <D9Label id="date-max" label="Max Date" />
+      <D9Label id="date-max" label="Max date" />
       <D9Input id="date-max" type="date" block v-model="maxDate" />
     </div>
     <div class="mb-4 flex items-center justify-between">
-      <D9Label id="no-past-dates" label="Do not allow past dates" />
+      <D9Label id="no-past-dates" label="No dates in the past" />
       <D9Switch id="no-past-dates" label="" v-model="noPastDates" />
     </div>
   </div>
diff --git a/resources/js/components/Factory/Main/ConfigureFile.vue b/resources/js/components/Factory/Main/ConfigureFile.vue
index 04ea2fd3..f65212d5 100644
--- a/resources/js/components/Factory/Main/ConfigureFile.vue
+++ b/resources/js/components/Factory/Main/ConfigureFile.vue
@@ -1,6 +1,6 @@
 <template>
   <div class="mb-4">
-    <D9Label label="Allowed File Types" />
+    <D9Label label="File types" />
     <div
       v-for="fileType in availableFileTypes"
       :key="fileType.key"
@@ -12,17 +12,17 @@
         :label="fileType.label"
       />
     </div>
+    <p class="mt-1 text-xs text-grey-600">None ticked: all types allowed.</p>
   </div>
 
   <div class="mb-4">
     <D9Label
       id="file-max-files"
-      label="Max Files"
-      :description="`The maximum number of allowed files to upload (max. ${maxFiles})`"
+      label="Most files"
+      :description="`1 to ${maxFiles}`"
     />
     <D9Input
       id="file-max-files"
-      :placeholder="`The maximum number of allowed files to upload (max. ${maxFiles})`"
       type="number"
       :min="1"
       :max="maxFiles"
@@ -35,12 +35,11 @@
   <div class="mb-4">
     <D9Label
       id="file-max-size"
-      label="Max Filesize"
-      :description="`The maximum file size in MB (max. ${maxFileSize} MB per file)`"
+      label="Largest file (MB)"
+      :description="`Up to ${maxFileSize} MB per file`"
     />
     <D9Input
       id="file-max-size"
-      :placeholder="`The maximum file size in MB (max. ${maxFileSize} MB per file)`"
       type="number"
       :min="1"
       :max="maxFileSize"
diff --git a/resources/js/components/Factory/Main/ConfigureInput.vue b/resources/js/components/Factory/Main/ConfigureInput.vue
index e65e6b41..3a79c6bd 100644
--- a/resources/js/components/Factory/Main/ConfigureInput.vue
+++ b/resources/js/components/Factory/Main/ConfigureInput.vue
@@ -1,6 +1,6 @@
 <template>
   <div class="mb-4">
-    <D9Label id="input-placeholder" label="Placeholder Text" />
+    <D9Label id="input-placeholder" label="Placeholder" />
     <D9Input
       id="input-placeholder"
       placeholder="Your placeholder text"
@@ -14,8 +14,8 @@
     <div class="mb-4">
       <D9Label
         id="input-decimal-places"
-        label="Decimal Places"
-        description="If empty, no decimal places are allowed"
+        label="Decimal places"
+        description="Leave empty for whole numbers only."
       />
       <D9Input
         id="input-decimal-places"
@@ -29,7 +29,11 @@
       />
     </div>
     <div class="mb-4">
-      <D9Label id="input-symbol" label="Show Symbol" />
+      <D9Label
+        id="input-symbol"
+        label="Symbol"
+        description="Shown next to the number, e.g. € or kg."
+      />
       <D9Input id="input-symbol" v-model="useSymbol" block maxlength="3" />
     </div>
   </template>
diff --git a/resources/js/components/Factory/Main/ConfigureRange.vue b/resources/js/components/Factory/Main/ConfigureRange.vue
index 37e661a6..bd714b58 100644
--- a/resources/js/components/Factory/Main/ConfigureRange.vue
+++ b/resources/js/components/Factory/Main/ConfigureRange.vue
@@ -1,20 +1,18 @@
 <template>
   <div v-if="isInitialized">
     <div class="mb-4">
-      <D9Label id="range-min" label="Min Rating" />
+      <D9Label id="range-min" label="Lowest value" />
       <D9Input
         id="range-min"
-        placeholder="Min Rating"
         type="number"
         block
         v-model="startValue"
       />
     </div>
     <div class="mb-4">
-      <D9Label id="range-max" label="Max Rating" />
+      <D9Label id="range-max" label="Highest value" />
       <D9Input
         id="range-max"
-        placeholder="Max Rating"
         type="number"
         block
         v-model="endValue"
@@ -22,20 +20,20 @@
     </div>
 
     <div class="mb-4">
-      <D9Label id="range-label-left" label="Left Label" />
+      <D9Label id="range-label-left" label="Label for lowest" />
       <D9Input
         id="range-label-left"
-        placeholder="Left Label"
+        placeholder="e.g. Not likely"
         type="text"
         block
         v-model="labelLeft"
       />
     </div>
     <div class="mb-4">
-      <D9Label id="range-label-right" label="Right Label" />
+      <D9Label id="range-label-right" label="Label for highest" />
       <D9Input
         id="range-label-right"
-        placeholder="Right Label"
+        placeholder="e.g. Very likely"
         type="text"
         block
         v-model="labelRight"
diff --git a/resources/js/components/Factory/Main/ConfigureTextarea.vue b/resources/js/components/Factory/Main/ConfigureTextarea.vue
index 4f938b5b..1f04bcdb 100644
--- a/resources/js/components/Factory/Main/ConfigureTextarea.vue
+++ b/resources/js/components/Factory/Main/ConfigureTextarea.vue
@@ -1,7 +1,7 @@
 <template>
   <div>
     <div class="mb-4">
-      <D9Label id="textarea-placeholder" label="Placeholder Text" />
+      <D9Label id="textarea-placeholder" label="Placeholder" />
       <D9Input
         id="textarea-placeholder"
         placeholder="Your placeholder text"
@@ -13,8 +13,8 @@
     <div class="mb-4">
       <D9Label
         id="textarea-rows"
-        label="Rows"
-        description="The max allowed number of rows is 10"
+        label="Height in lines"
+        description="1 to 10"
       />
       <D9Input
         id="textarea-rows"
@@ -28,7 +28,7 @@
       />
     </div>
     <div class="mb-4">
-      <D9Label id="textarea-max-chars" label="Max Characters" />
+      <D9Label id="textarea-max-chars" label="Max characters" />
       <D9Input
         id="textarea-max-chars"
         placeholder="The maximum number of characters"
diff --git a/resources/js/components/FieldLabels.test.ts b/resources/js/components/FieldLabels.test.ts
index ca3e2991..0a67df49 100644
--- a/resources/js/components/FieldLabels.test.ts
+++ b/resources/js/components/FieldLabels.test.ts
@@ -15,7 +15,7 @@ type Node = {
 
 // labels that head a group of controls or show a value, not a single field
 const groupLabels = [
-    "Factory/Main/ConfigureFile.vue: Allowed File Types",
+    "Factory/Main/ConfigureFile.vue: File types",
     "Factory/Settings/TemplateExport.vue: Template Files",
     "Factory/Settings/partials/ImageUpload.vue: (bound)",
     "Pages/Teams/Create.vue: Team Owner",

From 3d5ca41dcc613b6bd21ed4a98464d053556f4119 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 03:51:11 +0200
Subject: [PATCH 02/16] fix: say choice and consent in the choice and consent
 settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/EmptyState.vue                 |  4 ++--
 .../js/components/Factory/Main/ConfigureClicks.vue     |  3 +--
 .../js/components/Factory/Main/ConfigureConsents.vue   |  5 ++---
 .../Factory/Main/Interactions/ClickInteraction.vue     |  2 +-
 .../Factory/Main/Interactions/ConsentInteraction.vue   | 10 ++++------
 .../Main/Interactions/CustomResponseSettings.vue       |  6 ++----
 .../Main/Interactions/RandomizeResponsesSetting.vue    |  4 +---
 .../js/components/Factory/Main/NumberSettings.test.ts  | 10 +++++-----
 .../components/Factory/Shared/DeleteChoiceDialog.vue   |  4 ++--
 .../js/components/Factory/Shared/DeleteDialogs.test.ts |  4 ++--
 10 files changed, 22 insertions(+), 30 deletions(-)

diff --git a/resources/js/components/EmptyState.vue b/resources/js/components/EmptyState.vue
index 99191fb6..cbe2caa8 100644
--- a/resources/js/components/EmptyState.vue
+++ b/resources/js/components/EmptyState.vue
@@ -4,7 +4,7 @@
   >
     <div :class="isLoading ? 'opacity-0' : ''">
       <h3 class="font-heading font-medium text-grey-900">{{ title }}</h3>
-      <small class="block font-sans text-sm">
+      <small v-if="description" class="block font-sans text-sm">
         {{ description }}
       </small>
     </div>
@@ -22,7 +22,7 @@ import { D9Spinner } from "@deck9/ui";
 
 defineProps<{
   title: string;
-  description: string;
+  description?: string;
   isLoading?: boolean;
 }>();
 </script>
diff --git a/resources/js/components/Factory/Main/ConfigureClicks.vue b/resources/js/components/Factory/Main/ConfigureClicks.vue
index ffa52296..16fa6408 100644
--- a/resources/js/components/Factory/Main/ConfigureClicks.vue
+++ b/resources/js/components/Factory/Main/ConfigureClicks.vue
@@ -2,8 +2,7 @@
   <div>
     <EmptyState
       v-if="editableInteractions?.length === 0"
-      title="Nothing here yet."
-      description="Add your first choice with the button below."
+      title="No choices yet."
     />
 
     <Container
diff --git a/resources/js/components/Factory/Main/ConfigureConsents.vue b/resources/js/components/Factory/Main/ConfigureConsents.vue
index ccd1c473..35f9a6ac 100644
--- a/resources/js/components/Factory/Main/ConfigureConsents.vue
+++ b/resources/js/components/Factory/Main/ConfigureConsents.vue
@@ -2,8 +2,7 @@
   <div>
     <EmptyState
       v-if="workbench.currentInteractions?.length === 0"
-      title="Nothing here yet."
-      description="Add your first policy with the button below."
+      title="No consents yet."
     />
 
     <Container
@@ -34,7 +33,7 @@
         @click="createConsentPolicy"
       >
         <D9Icon name="plus" aria-hidden="true" />
-        Add policy
+        Add consent
       </button>
     </div>
   </div>
diff --git a/resources/js/components/Factory/Main/Interactions/ClickInteraction.vue b/resources/js/components/Factory/Main/Interactions/ClickInteraction.vue
index 37038376..03d63e85 100644
--- a/resources/js/components/Factory/Main/Interactions/ClickInteraction.vue
+++ b/resources/js/components/Factory/Main/Interactions/ClickInteraction.vue
@@ -14,7 +14,7 @@
           type="text"
           v-model="label"
           block
-          placeholder="Label"
+          :placeholder="`Choice ${index + 1}`"
           @keyup.enter="keyboardCommands"
           @keyup.up.exact="keyboardCommands"
           @keyup.down.exact="keyboardCommands"
diff --git a/resources/js/components/Factory/Main/Interactions/ConsentInteraction.vue b/resources/js/components/Factory/Main/Interactions/ConsentInteraction.vue
index 3cb16fb8..0be0b728 100644
--- a/resources/js/components/Factory/Main/Interactions/ConsentInteraction.vue
+++ b/resources/js/components/Factory/Main/Interactions/ConsentInteraction.vue
@@ -4,11 +4,11 @@
     :class="[index === 0 ? 'mt-4' : 'mt-8']"
   >
     <div class="flex items-center">
-      <h3 class="font-medium">Consent Policy</h3>
+      <h3 class="font-medium">Consent</h3>
       <IndexItem class="ml-2" type="button" v-bind="{ index }" />
       <ChoiceRowActions
         class="ml-auto"
-        :label="label ? `policy “${label}”` : `policy ${index + 1}`"
+        :label="label ? `consent “${label}”` : `consent ${index + 1}`"
         @onDelete="askDelete"
       />
     </div>
@@ -37,14 +37,12 @@
         </div>
         <div class="flex items-center">
           <D9Switch
-            onLabel="Yes"
-            offLabel="No"
-            label="Opt-In Required"
+            label="Must be ticked"
             :id="item.id + '_required'"
             v-model="isRequired"
           />
           <label :for="item.id + '_required'" class="ml-2 inline-block"
-            >Consent required</label
+            >Must be ticked</label
           >
         </div>
       </section>
diff --git a/resources/js/components/Factory/Main/Interactions/CustomResponseSettings.vue b/resources/js/components/Factory/Main/Interactions/CustomResponseSettings.vue
index ca2471e4..b404b226 100644
--- a/resources/js/components/Factory/Main/Interactions/CustomResponseSettings.vue
+++ b/resources/js/components/Factory/Main/Interactions/CustomResponseSettings.vue
@@ -1,13 +1,11 @@
 <template>
   <div>
     <div class="flex justify-between">
-      <D9Label id="custom-response" label="Allow Custom Response" />
+      <D9Label id="custom-response" label="Add “Other” with a text field" />
       <D9Switch
         id="custom-response"
         label=""
         v-model="useCustomResponse"
-        onLabel="yes"
-        offLabel="no"
         @change="updateCustomResponseSetting"
       />
     </div>
@@ -15,7 +13,7 @@
       <D9Input
         v-model="customResponseLabel"
         block
-        placeholder="Label for Custom Response Option"
+        placeholder="Label for “Other”"
       />
     </div>
   </div>
diff --git a/resources/js/components/Factory/Main/Interactions/RandomizeResponsesSetting.vue b/resources/js/components/Factory/Main/Interactions/RandomizeResponsesSetting.vue
index 9c2dc1bc..8ca17efe 100644
--- a/resources/js/components/Factory/Main/Interactions/RandomizeResponsesSetting.vue
+++ b/resources/js/components/Factory/Main/Interactions/RandomizeResponsesSetting.vue
@@ -1,13 +1,11 @@
 <template>
   <div>
     <div class="flex justify-between">
-      <D9Label id="randomize-responses" label="Randomize Responses" />
+      <D9Label id="randomize-responses" label="Shuffle choices" />
       <D9Switch
         id="randomize-responses"
         label=""
         v-model="randomizeResponses"
-        onLabel="yes"
-        offLabel="no"
         @change="updateRandomizeResponsesSetting"
       />
     </div>
diff --git a/resources/js/components/Factory/Main/NumberSettings.test.ts b/resources/js/components/Factory/Main/NumberSettings.test.ts
index ce48eccf..73893677 100644
--- a/resources/js/components/Factory/Main/NumberSettings.test.ts
+++ b/resources/js/components/Factory/Main/NumberSettings.test.ts
@@ -37,7 +37,7 @@ vi.mock("../utils/useInteractionsUtils", () => ({
     }),
 }));
 
-// types into one field and returns the options the settings would save
+// types into one field, found by id, and returns the options the settings would save
 const savedOptions = async (
     component: Component,
     field: string,
@@ -58,19 +58,19 @@ const savedOptions = async (
         },
     });
     await flushPromises();
-    await wrapper.find(`input[placeholder^="${field}"]`).setValue(typed);
+    await wrapper.find(`input#${field}`).setValue(typed);
     await flushPromises();
 
     return save.mock.lastCall?.[0].options;
 };
 
 const savedDecimalPlaces = async (typed: string) =>
-    (await savedOptions(ConfigureInput, "Number of decimal places", typed))
+    (await savedOptions(ConfigureInput, "input-decimal-places", typed))
         ?.decimalPlaces;
 
 describe("file limits in the file block settings", () => {
     it("clamps max files to 1 to 10 before saving", async () => {
-        const files = "The maximum number of allowed files";
+        const files = "file-max-files";
         expect(
             (await savedOptions(ConfigureFile, files, "50"))?.allowedFiles,
         ).toBe(10);
@@ -80,7 +80,7 @@ describe("file limits in the file block settings", () => {
     });
 
     it("clamps max size to 1 to 8 MB before saving", async () => {
-        const size = "The maximum file size";
+        const size = "file-max-size";
         expect(
             (await savedOptions(ConfigureFile, size, "99"))?.allowedFileSize,
         ).toBe(8);
diff --git a/resources/js/components/Factory/Shared/DeleteChoiceDialog.vue b/resources/js/components/Factory/Shared/DeleteChoiceDialog.vue
index 16b197db..152c8802 100644
--- a/resources/js/components/Factory/Shared/DeleteChoiceDialog.vue
+++ b/resources/js/components/Factory/Shared/DeleteChoiceDialog.vue
@@ -3,7 +3,7 @@
     :show="choice !== null"
     :title="title"
     :text="text"
-    :confirm-label="policy ? 'Delete policy' : 'Delete choice'"
+    :confirm-label="policy ? 'Delete consent' : 'Delete choice'"
     @close="emit('close')"
     @confirm="emit('confirm')"
   />
@@ -31,7 +31,7 @@ const title = computed(() => {
   const label = props.choice?.label;
 
   if (props.policy) {
-    return label ? `Delete policy “${label}”?` : "Delete this policy?";
+    return label ? `Delete consent “${label}”?` : "Delete this consent?";
   }
 
   return label ? `Delete “${label}”?` : "Delete this choice?";
diff --git a/resources/js/components/Factory/Shared/DeleteDialogs.test.ts b/resources/js/components/Factory/Shared/DeleteDialogs.test.ts
index 3bc410c5..4d7ba481 100644
--- a/resources/js/components/Factory/Shared/DeleteDialogs.test.ts
+++ b/resources/js/components/Factory/Shared/DeleteDialogs.test.ts
@@ -361,12 +361,12 @@ describe("asking before a delete", () => {
             await pressTrash();
 
             expect(wrapper.emitted("onDelete")).toBeUndefined();
-            expect(wrapper.text()).toContain("Delete policy “Privacy policy”?");
+            expect(wrapper.text()).toContain("Delete consent “Privacy policy”?");
             expect(wrapper.text()).toContain(
                 "3 people agreed to it. Their answers to it will be deleted.",
             );
             expect(wrapper.find("button.bg-red-600").text()).toBe(
-                "Delete policy",
+                "Delete consent",
             );
 
             await wrapper.find("button.bg-red-600").trigger("click");

From 0e9e6a9c9169f690b9cfdbf742fd5fa68538e460 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:01:57 +0200
Subject: [PATCH 03/16] fix: name the settings by answer type and say where the
 short name shows

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Factory/Document/QuestionSettings.test.ts | 37 +++++++++++++++++++
 .../Factory/Document/QuestionSettings.vue     | 28 +++++++++++---
 2 files changed, 60 insertions(+), 5 deletions(-)
 create mode 100644 resources/js/components/Factory/Document/QuestionSettings.test.ts

diff --git a/resources/js/components/Factory/Document/QuestionSettings.test.ts b/resources/js/components/Factory/Document/QuestionSettings.test.ts
new file mode 100644
index 00000000..23067a5f
--- /dev/null
+++ b/resources/js/components/Factory/Document/QuestionSettings.test.ts
@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import { shallowMount } from "@vue/test-utils";
+import QuestionSettings from "./QuestionSettings.vue";
+
+const heading = (type: string, interactionType?: FormBlockInteractionType) =>
+    shallowMount(QuestionSettings, {
+        props: {
+            id: "settings",
+            block: {
+                uuid: "q1",
+                type,
+                interactions: [],
+            } as unknown as FormBlockModel,
+            interactionType,
+        },
+    })
+        .find("h3")
+        .text();
+
+describe("the settings heading", () => {
+    it.each([
+        ["radio", "button", "Choices"],
+        ["input-short", "input", "Answer field"],
+        ["input-long", "textarea", "Answer field"],
+        ["rating", "range", "Rating"],
+        ["scale", "range", "Scale"],
+        ["date", "date", "Date"],
+        ["input-file", "file", "File upload"],
+        ["consent", "consent", "Consent"],
+        ["none", undefined, "Settings"],
+    ] as const)(
+        "names a %s question's settings %s → %s",
+        (type, interaction, text) => {
+            expect(heading(type, interaction)).toBe(text);
+        },
+    );
+});
diff --git a/resources/js/components/Factory/Document/QuestionSettings.vue b/resources/js/components/Factory/Document/QuestionSettings.vue
index 17893bb0..f98eafb7 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.vue
+++ b/resources/js/components/Factory/Document/QuestionSettings.vue
@@ -11,7 +11,7 @@
       class="text-xs font-semibold text-grey-600"
       :class="sheet && 'sr-only'"
     >
-      Settings
+      {{ heading }}
     </h3>
 
     <ConfigureInput v-if="interactionType === 'input'" />
@@ -33,11 +33,10 @@
       <label
         :for="`${id}-identifier`"
         class="block text-sm font-medium text-grey-900"
-        >Identifier</label
+        >Short name</label
       >
       <p :id="`${id}-identifier-help`" class="mb-1 text-xs text-grey-600">
-        This name is used when submitting your form through webhooks and in the
-        export.
+        Used in prefill links, webhooks, emails and the submissions table.
       </p>
       <D9Input
         :id="`${id}-identifier`"
@@ -68,7 +67,7 @@
 </template>
 
 <script setup lang="ts">
-import { ref, watch } from "vue";
+import { computed, ref, watch } from "vue";
 import { D9Input, D9Switch } from "@deck9/ui";
 import { useWorkbench } from "@/stores";
 import useActiveInteractions from "@/components/Factory/Shared/useActiveInteractions";
@@ -91,6 +90,25 @@ const props = defineProps<{
 const workbench = useWorkbench();
 const { editableInteractions } = useActiveInteractions(props.block);
 
+// named by answer type; "Text only" has no answer settings
+const headings: Partial<Record<FormBlockInteractionType, string>> = {
+  button: "Choices",
+  input: "Answer field",
+  textarea: "Answer field",
+  date: "Date",
+  file: "File upload",
+  consent: "Consent",
+};
+const heading = computed(() => {
+  if (props.interactionType === "range") {
+    return props.block.type === "scale" ? "Scale" : "Rating";
+  }
+
+  return (
+    (props.interactionType && headings[props.interactionType]) ?? "Settings"
+  );
+});
+
 const title = ref(props.block.title ?? "");
 const hidden = ref(props.block.is_disabled ?? false);
 

From 0a5b7a1c8ad883c80f74fc5a6ee347ffa3a7fb71 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:02:25 +0200
Subject: [PATCH 04/16] fix: show every switch in the editor as on or off

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Document/EndScreenBlock.vue   | 2 --
 resources/js/components/Factory/Document/QuestionCard.vue     | 2 --
 resources/js/components/Factory/Document/QuestionSettings.vue | 2 --
 3 files changed, 6 deletions(-)

diff --git a/resources/js/components/Factory/Document/EndScreenBlock.vue b/resources/js/components/Factory/Document/EndScreenBlock.vue
index 58b20d29..5afb81f5 100644
--- a/resources/js/components/Factory/Document/EndScreenBlock.vue
+++ b/resources/js/components/Factory/Document/EndScreenBlock.vue
@@ -60,8 +60,6 @@
             id="end-screen-button"
             v-model="draft.show_cta_link"
             label="Button"
-            onLabel="Yes"
-            offLabel="No"
           />
           <Link
             :href="settingsLink"
diff --git a/resources/js/components/Factory/Document/QuestionCard.vue b/resources/js/components/Factory/Document/QuestionCard.vue
index 1a3664d4..c99dc8b1 100644
--- a/resources/js/components/Factory/Document/QuestionCard.vue
+++ b/resources/js/components/Factory/Document/QuestionCard.vue
@@ -50,8 +50,6 @@
           :id="`${id}-required`"
           v-model="required"
           label="Required"
-          onLabel="Yes"
-          offLabel="No"
         />
       </div>
 
diff --git a/resources/js/components/Factory/Document/QuestionSettings.vue b/resources/js/components/Factory/Document/QuestionSettings.vue
index f98eafb7..ce1e0da3 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.vue
+++ b/resources/js/components/Factory/Document/QuestionSettings.vue
@@ -59,8 +59,6 @@
         :id="`${id}-hidden`"
         v-model="hidden"
         label="Hide this question"
-        onLabel="Yes"
-        offLabel="No"
       />
     </div>
   </div>

From 3170da7751e3fefd0029004ef5a0a6101aef2fdb Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:03:35 +0200
Subject: [PATCH 05/16] fix: use plain words in the text editor's toolbar,
 counter and prompts

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../components/Factory/Shared/Editor.test.ts  | 20 ++++++-------------
 .../js/components/Factory/Shared/Editor.vue   | 20 +++++++++----------
 resources/js/utils/useContentLength.ts        |  7 +------
 3 files changed, 17 insertions(+), 30 deletions(-)

diff --git a/resources/js/components/Factory/Shared/Editor.test.ts b/resources/js/components/Factory/Shared/Editor.test.ts
index c0a8c4c2..2140bcb1 100644
--- a/resources/js/components/Factory/Shared/Editor.test.ts
+++ b/resources/js/components/Factory/Shared/Editor.test.ts
@@ -72,23 +72,15 @@ describe("block text counter", () => {
     editor.commands.undo();
     await nextTick();
 
-    expect(opened).toMatch(/^\d+ chars, \d+ words$/);
+    expect(opened).toMatch(/^\d+ characters$/);
     expect(opened).toBe(counter(wrapper));
   });
 
-  it("counts an empty text as 0 chars, 0 words", async () => {
-    expect(counter(await open())).toBe("0 chars, 0 words");
+  it("counts an empty text as 0 characters", async () => {
+    expect(counter(await open())).toBe("0 characters");
   });
 
-  it.each([
-    ["<h2>Hi</h2><p>there</p>", 2],
-    ["<ul><li><p>one</p></li><li><p>two</p></li></ul>", 2],
-    ["<p></p><p></p>", 0],
-  ])("counts %s as %i words", async (html, words) => {
-    expect(counter(await open(html))).toMatch(`, ${words} words`);
-  });
-
-  it("counts a text of only spaces as 0 words", async () => {
+  it("counts spaces as characters", async () => {
     const wrapper = await open();
     const editor = wrapper
       .findComponent(EditorContent)
@@ -97,7 +89,7 @@ describe("block text counter", () => {
     editor.view.dispatch(editor.state.tr.insertText("   "));
     await nextTick();
 
-    expect(counter(wrapper)).toBe("3 chars, 0 words");
+    expect(counter(wrapper)).toBe("3 characters");
   });
 });
 
@@ -114,6 +106,6 @@ describe("a bare editor", () => {
       .findComponent(EditorContent)
       .props("editor") as TiptapEditor;
     expect(editor.view.dom.classList).not.toContain("border");
-    expect(wrapper.text()).not.toContain("chars");
+    expect(wrapper.text()).not.toContain("characters");
   });
 });
diff --git a/resources/js/components/Factory/Shared/Editor.vue b/resources/js/components/Factory/Shared/Editor.vue
index faa6af98..a078f938 100644
--- a/resources/js/components/Factory/Shared/Editor.vue
+++ b/resources/js/components/Factory/Shared/Editor.vue
@@ -53,7 +53,7 @@
           v-bind="{
             isActive: editor?.isActive('heading', { level: 2 }) ?? false,
             icon: 'heading',
-            label: 'Heading 1',
+            label: 'Heading',
             subLabel: '1',
           }"
           @click="editor?.chain().focus().toggleHeading({ level: 2 }).run()"
@@ -62,7 +62,7 @@
           v-bind="{
             isActive: editor?.isActive('heading', { level: 3 }) ?? false,
             icon: 'heading',
-            label: 'Heading 2',
+            label: 'Subheading',
             subLabel: '2',
           }"
           @click="editor?.chain().focus().toggleHeading({ level: 3 }).run()"
@@ -73,7 +73,7 @@
           v-bind="{
             isActive: editor?.isActive('bulletList') ?? false,
             icon: 'list-ul',
-            label: 'Bullet List',
+            label: 'Bullet list',
           }"
           @click="editor?.chain().focus().toggleBulletList().run()"
         />
@@ -81,7 +81,7 @@
           v-bind="{
             isActive: editor?.isActive('orderedList') ?? false,
             icon: 'list-ol',
-            label: 'Ordered List',
+            label: 'Numbered list',
           }"
           @click="editor?.chain().focus().toggleOrderedList().run()"
         />
@@ -109,7 +109,7 @@
           v-bind="{
             isActive: false,
             icon: 'remove-format',
-            label: 'Remove Formatting',
+            label: 'Clear formatting',
           }"
           @click="editor?.chain().focus().clearNodes().unsetAllMarks().run()"
         />
@@ -117,7 +117,7 @@
     </div>
     <editor-content :editor="editor" />
     <div v-if="counter" class="mt-1 text-xs text-grey-600">
-      {{ chars }} chars, {{ words }} words
+      {{ chars }} characters
     </div>
   </div>
 </template>
@@ -150,7 +150,7 @@ const {
 
 const content = ref("");
 
-const { chars, words } = useContentLength(content);
+const { chars } = useContentLength(content);
 
 const emit = defineEmits<{
   (event: "update:modelValue", value: string): void;
@@ -215,7 +215,7 @@ const setLink = () => {
   }
 
   const previousUrl = editor.value.getAttributes("link").href;
-  const url = window.prompt("URL", previousUrl);
+  const url = window.prompt("Link address", previousUrl);
 
   // cancelled
   if (url === null) {
@@ -244,7 +244,7 @@ const setImage = () => {
   }
 
   const previousUrl = editor.value.getAttributes("image").src;
-  const url = window.prompt("URL", previousUrl);
+  const url = window.prompt("Image address", previousUrl);
 
   // cancelled
   if (url === null || url === "") {
@@ -252,7 +252,7 @@ const setImage = () => {
   }
 
   if (!url.startsWith("https")) {
-    window.alert("Please enter a valid secure URL");
+    window.alert("The image address must start with https://");
     return;
   }
 
diff --git a/resources/js/utils/useContentLength.ts b/resources/js/utils/useContentLength.ts
index cba81805..d354fee3 100644
--- a/resources/js/utils/useContentLength.ts
+++ b/resources/js/utils/useContentLength.ts
@@ -2,15 +2,10 @@ import { computed, ComputedRef, Ref } from "vue";
 
 export function useContentLength(content: Ref<string>): {
     chars: ComputedRef<number>;
-    words: ComputedRef<number>;
 } {
     const chars = computed(() => {
         return content.value.length;
     });
 
-    const words = computed(() => {
-        return content.value.split(/\s+/).filter(Boolean).length;
-    });
-
-    return { chars, words };
+    return { chars };
 }

From 3e1e426719455e43c3cd709c289875f25486469d Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:03:35 +0200
Subject: [PATCH 06/16] fix: name new rules Rule 1 and give the group name an
 example

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Document/DocumentGroup.vue    | 2 +-
 resources/js/components/Factory/Document/Rules/ruleEditing.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/resources/js/components/Factory/Document/DocumentGroup.vue b/resources/js/components/Factory/Document/DocumentGroup.vue
index 9a8eedd6..ce351b3a 100644
--- a/resources/js/components/Factory/Document/DocumentGroup.vue
+++ b/resources/js/components/Factory/Document/DocumentGroup.vue
@@ -24,7 +24,7 @@
         :id="`${id}-name`"
         v-model="name"
         type="text"
-        placeholder="Group"
+        placeholder="e.g. About you"
         title="Use a group to show or hide several questions with one rule."
         class="h-11 min-w-0 flex-1 rounded-md border-0 bg-transparent px-2 text-base font-semibold lg:h-9 lg:text-sm text-grey-700 placeholder:text-grey-600 hover:bg-grey-100 focus:bg-white focus:ring-2 focus:ring-blue-500"
       />
diff --git a/resources/js/components/Factory/Document/Rules/ruleEditing.ts b/resources/js/components/Factory/Document/Rules/ruleEditing.ts
index df019ead..7c0d49dd 100644
--- a/resources/js/components/Factory/Document/Rules/ruleEditing.ts
+++ b/resources/js/components/Factory/Document/Rules/ruleEditing.ts
@@ -51,7 +51,7 @@ export function addRule(block: FormBlockModel) {
         ...logics,
         {
             form_block_id: block.id,
-            name: `Rule #${logics.length + 1}`,
+            name: `Rule ${logics.length + 1}`,
             action: isGroup ? "hide" : "goto",
             action_payload: null,
             evaluate: isGroup ? "before" : "after",

From 50015c0aa61616ff98a9c069c5e3820f4bb51246 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:07:45 +0200
Subject: [PATCH 07/16] docs: use the editor's new setting names in the help
 pages

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/embedding-forms.md            | 4 ++--
 docs/input-types/consent.md        | 2 +-
 docs/input-types/date.md           | 6 +++---
 docs/input-types/file-upload.md    | 6 +++---
 docs/input-types/long-text.md      | 4 ++--
 docs/input-types/multiplechoice.md | 2 +-
 docs/input-types/number.md         | 4 ++--
 docs/input-types/rating.md         | 8 ++++----
 docs/input-types/scale.md          | 8 ++++----
 docs/managing-submissions.md       | 2 +-
 docs/workbench/workbench.md        | 4 ++--
 11 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/docs/embedding-forms.md b/docs/embedding-forms.md
index 306a3109..ba20040d 100644
--- a/docs/embedding-forms.md
+++ b/docs/embedding-forms.md
@@ -115,13 +115,13 @@ https://app.getinput.co/form-uuid?iframe=1&hideTitle=1&alignLeft=1
 
 ## Prefill Questions
 
-You can fill in answers with URL parameters. The parameter name is the question's Identifier (open the question, then "More Settings"). For example, this fills the question with the Identifier `email`:
+You can fill in answers with URL parameters. The parameter name is the question's short name (open the question, then **Settings**, then **Short name**). For example, this fills the question with the short name `email`:
 
 ```
 https://app.getinput.co/form-uuid?email=ada@example.com
 ```
 
--   Works for short text, long text, email, number, phone and link questions. Parameters for other question types or unknown Identifiers are ignored.
+-   Works for short text, long text, email, number, phone and link questions. Parameters for other question types or unknown short names are ignored.
 -   The question still shows, so the visitor can check and change the answer. A question skipped by a jump doesn't send its prefilled answer.
 -   The value shows as plain text. Encode special characters: `%2B` for `+`, `%20` for a space.
 -   Number questions take digits with a dot as decimal separator, like `price=12.5`, rounded to the question's decimal places. Anything else is ignored.
diff --git a/docs/input-types/consent.md b/docs/input-types/consent.md
index 00830474..8dbb3012 100644
--- a/docs/input-types/consent.md
+++ b/docs/input-types/consent.md
@@ -7,7 +7,7 @@ The Consent input type is designed specifically for gathering agreement from use
 1. Choose **Consent** as the input type
 2. Enter a clear message explaining what the user is consenting to
 3. Configure the consent option with a concise label
-4. Toggle "Opt-In Required" if the consent is mandatory to proceed
+4. Turn on "Must be ticked" if people must agree to go on
 
 ::: tip Best Practice
 < Keep consent messages clear and specific. Explain exactly what users are agreeing to, and include links to relevant policies when appropriate.
diff --git a/docs/input-types/date.md b/docs/input-types/date.md
index 328c8701..deb97f7c 100644
--- a/docs/input-types/date.md
+++ b/docs/input-types/date.md
@@ -7,9 +7,9 @@ The Date input type allows users to select dates from a calendar interface, maki
 1. Choose **Date** as the input type
 2. Enter the question or prompt asking for a date
 3. Configure the date restrictions (optional):
-    - **Minimum Date**: Earliest date users can select
-    - **Maximum Date**: Latest date users can select
-    - **No Past Dates**: Toggle to prevent selection of dates before today
+    - **Min date**: Earliest date users can select
+    - **Max date**: Latest date users can select
+    - **No dates in the past**: Turn on to prevent selection of dates before today
 
 ::: tip Best Practice
 < Always specify what kind of date you're asking for (appointment date, birth date, event date, etc.) and the expected format in your prompt.
diff --git a/docs/input-types/file-upload.md b/docs/input-types/file-upload.md
index af5bc001..9656032b 100644
--- a/docs/input-types/file-upload.md
+++ b/docs/input-types/file-upload.md
@@ -7,9 +7,9 @@ The File upload input type allows users to attach files to their form responses.
 1. Choose **File upload** as the input type
 2. Enter instructions for what files users should upload
 3. Configure the upload settings:
-    - **Maximum Files**: Set how many files users can upload
-    - **Maximum File Size**: Limit file size (in MB)
-    - **Allowed File Types**: Choose which file formats are accepted
+    - **Most files**: How many files users can upload (1 to 10)
+    - **Largest file (MB)**: Up to 8 MB per file
+    - **File types**: Choose which file formats are accepted. None ticked: all types allowed
 
 ::: tip Best Practice
 < Be specific about what files you're looking for and any requirements (format, size, resolution, etc.) to avoid confusion and unsuccessful uploads.
diff --git a/docs/input-types/long-text.md b/docs/input-types/long-text.md
index ca5e5ad0..7f88b859 100644
--- a/docs/input-types/long-text.md
+++ b/docs/input-types/long-text.md
@@ -7,8 +7,8 @@ The Long text input type provides a multi-line text area for collecting detailed
 1. Select **Long text** as the input type
 2. Enter the question or prompt
 3. Configure the text area options:
-   - **Rows**: Number of visible text rows (1-10, default: 5)
-   - **Maximum Characters**: Limit on response length (default: 500)
+   - **Height in lines**: How many lines the field shows (1 to 10, default: 5)
+   - **Max characters**: Limit on response length (default: 500)
    - **Placeholder**: Hint text shown when the field is empty
 4. Toggle the "Required" option if necessary
 
diff --git a/docs/input-types/multiplechoice.md b/docs/input-types/multiplechoice.md
index 7e7e4a4b..52615a8d 100644
--- a/docs/input-types/multiplechoice.md
+++ b/docs/input-types/multiplechoice.md
@@ -14,7 +14,7 @@ This input type allows users to select one option from a list of choices, perfec
 -   **Single Selection**: Users can select exactly one option
 -   **Visual Clarity**: Clear indication of which option is selected
 -   **Option Ordering**: Arrange options in a meaningful sequence
--   **Randomization**: Option to randomize choice order to reduce bias (if available)
+-   **Shuffle choices**: Show the choices in a random order to reduce bias
 
 ## Example Uses:
 
diff --git a/docs/input-types/number.md b/docs/input-types/number.md
index 1ac92c3d..85f66709 100644
--- a/docs/input-types/number.md
+++ b/docs/input-types/number.md
@@ -7,8 +7,8 @@ The Number input type is specifically designed for collecting numerical data wit
 1. Choose **Number** as the input type
 2. Enter the question or prompt
 3. Configure the number options:
-   - **Decimal Places**: How many decimal digits to allow (0-10)
-   - **Symbol**: Optional character(s) to display before the number (e.g., $, €, %)
+   - **Decimal places**: How many decimal digits to allow (0-10). Leave empty for whole numbers only
+   - **Symbol**: Shown next to the number, e.g. € or kg
    - **Placeholder**: Hint text to show when the field is empty
 4. Toggle the "Required" option if necessary
 
diff --git a/docs/input-types/rating.md b/docs/input-types/rating.md
index d9291023..a167d5dc 100644
--- a/docs/input-types/rating.md
+++ b/docs/input-types/rating.md
@@ -7,10 +7,10 @@ The Rating input type allows users to provide feedback on a visual scale using i
 1. Choose **Rating** as the input type
 2. Enter the prompt for what's being rated
 3. Configure the rating options:
-   - **Min Rating**: Starting point for the scale (default: 1)
-   - **Max Rating**: Maximum value on the scale (default: 5)
-   - **Left Label**: Optional text at the start of the scale (e.g., "Poor")
-   - **Right Label**: Optional text at the end of the scale (e.g., "Excellent")
+   - **Lowest value**: Starting point for the scale (default: 1)
+   - **Highest value**: Maximum value on the scale (default: 5)
+   - **Label for lowest**: Optional text at the start of the scale (e.g., "Poor")
+   - **Label for highest**: Optional text at the end of the scale (e.g., "Excellent")
    - **Icon**: Choose from stars, hearts, trophies, and other symbols
    - **Color**: Customize the color of the rating icons
 4. Toggle the "Required" option if necessary
diff --git a/docs/input-types/scale.md b/docs/input-types/scale.md
index a2c53c4b..070d6f70 100644
--- a/docs/input-types/scale.md
+++ b/docs/input-types/scale.md
@@ -7,10 +7,10 @@ The Scale input type presents users with a numerical range from which they can s
 1. Select **Scale** as the input type
 2. Enter the question or prompt
 3. Configure the scale options:
-   - **Min Rating**: Starting number for the scale (default: 1)
-   - **Max Rating**: Ending number for the scale (default: 5)
-   - **Left Label**: Text description for the low end of the scale (e.g., "Strongly Disagree")
-   - **Right Label**: Text description for the high end of the scale (e.g., "Strongly Agree")
+   - **Lowest value**: Starting number for the scale (default: 1)
+   - **Highest value**: Ending number for the scale (default: 5)
+   - **Label for lowest**: Text description for the low end of the scale (e.g., "Strongly Disagree")
+   - **Label for highest**: Text description for the high end of the scale (e.g., "Strongly Agree")
 4. Toggle the "Required" option if necessary
 
 ## Features:
diff --git a/docs/managing-submissions.md b/docs/managing-submissions.md
index 168d213d..8e15a618 100644
--- a/docs/managing-submissions.md
+++ b/docs/managing-submissions.md
@@ -28,7 +28,7 @@ The Table View displays each individual submission in a tabular format:
 
 The Summary View provides an aggregated analysis of your submissions:
 
--   For multiple choice questions: shows response distributions with visual graphs
+-   For single choice and checkbox questions: shows response distributions with visual graphs
 -   For text inputs: displays common responses
 -   For numerical inputs: shows average values and ranges
 -   For rating scales: presents average ratings with visual indicators
diff --git a/docs/workbench/workbench.md b/docs/workbench/workbench.md
index 57d3ecb4..8103406b 100644
--- a/docs/workbench/workbench.md
+++ b/docs/workbench/workbench.md
@@ -14,7 +14,7 @@ Each question shows:
 
 -   Its number and an icon for its answer type
 -   Its text, on up to two lines
--   A line below with the answer type, the number of choices, **Required**, the number of rules, **Hidden**, and its identifier if you gave it one
+-   A line below with the answer type, the number of choices, **Required**, the number of rules, **Hidden**, and its short name if you gave it one
 
 Groups show their name with their questions inside. An empty group says how to add a question to it.
 
@@ -26,7 +26,7 @@ Click a question, or move to it with Tab and press Enter, to open it in place. T
 2. **Choices** - For single choice and checkboxes. Each row has a grip to drag it and a delete button. Alt+Up and Alt+Down move a choice
 3. **Answer type** - Change what kind of answer the question takes
 4. **Required** - Whether people must answer it
-5. **Settings** - The settings of this answer type, the identifier and **Hide this question**. On a phone they open as a sheet from the bottom
+5. **Settings** - The settings of this answer type under its own heading (for example **Choices** or **Rating**), then **Short name** and **Hide this question**. On a phone they open as a sheet from the bottom
 6. **Rules** - Logic rules for this question, see [Conditional Logic](./conditional-logic.md)
 7. **Menu (…)** - Duplicate, Add question below, Move up, Move down, Copy question ID and Delete
 

From f77efdb9616841f80734446053e7e59de9def2cc Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:18:34 +0200
Subject: [PATCH 08/16] docs: add the editor wording change to the changelog

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1eaac9fb..cd5af102 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,6 +29,7 @@ Lines marked **Upgrade step** need you to act after updating.
 -   The form editor shows your whole form as one column. Each question shows its number, answer type, text, and if it is required, has rules or is hidden. The question you work on opens right there, also on a phone, where you couldn't edit questions before. Hiding a question, random order and custom answers are now under the question's Settings. An outline next to the form jumps to any question, and on a phone a question's Settings open from the bottom of the screen. Move a question with Alt+Up/Down, with Move up and Move down in its menu, or by dragging. Duplicate in a question's menu puts a copy right below it. (#268, #272, #275, #277)
 -   Deleting a question, a group, an answer choice, a consent policy or a logic rule in the form editor now asks first in the app's own dialog. It names the question, how many answers will be deleted with it, and the questions whose rules will stop working. A choice nobody picked, or a policy nobody agreed to, is still deleted at once. (#269)
 -   Each rule now shows as a sentence under its question, and a group says when it's hidden. Edit changes a rule right there, and for choices, ratings and scales you pick the answer instead of typing it. A rule whose question was deleted shows in red and can't be saved until you fix it. (#274)
+-   The form editor uses plain words: a question's settings are headed by its answer type, like Choices or Rating, "Identifier" is now "Short name", and every switch shows on or off. Settings name what they do, like "Lowest value", "Shuffle choices" and "None ticked: all types allowed." on file uploads. (#279)
 
 ### Fixed
 

From b698273b35224526861a2e7e83e100591794ad53 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:29:51 +0200
Subject: [PATCH 09/16] fix: don't say emails use the short name

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Document/QuestionSettings.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/js/components/Factory/Document/QuestionSettings.vue b/resources/js/components/Factory/Document/QuestionSettings.vue
index ce1e0da3..0944084c 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.vue
+++ b/resources/js/components/Factory/Document/QuestionSettings.vue
@@ -36,7 +36,7 @@
         >Short name</label
       >
       <p :id="`${id}-identifier-help`" class="mb-1 text-xs text-grey-600">
-        Used in prefill links, webhooks, emails and the submissions table.
+        Used in prefill links, webhooks and the submissions table.
       </p>
       <D9Input
         :id="`${id}-identifier`"

From 4ee7e54abba3830772769cdaf487b5fae0f5ca49 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:30:45 +0200
Subject: [PATCH 10/16] fix: tie "None ticked: all types allowed." to the file
 type boxes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../js/components/Factory/Main/ConfigureFile.vue    | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/resources/js/components/Factory/Main/ConfigureFile.vue b/resources/js/components/Factory/Main/ConfigureFile.vue
index f65212d5..f03cafff 100644
--- a/resources/js/components/Factory/Main/ConfigureFile.vue
+++ b/resources/js/components/Factory/Main/ConfigureFile.vue
@@ -1,6 +1,11 @@
 <template>
-  <div class="mb-4">
-    <D9Label label="File types" />
+  <div
+    class="mb-4"
+    role="group"
+    aria-labelledby="file-types-label"
+    aria-describedby="file-types-help"
+  >
+    <D9Label id="file-types" label="File types" />
     <div
       v-for="fileType in availableFileTypes"
       :key="fileType.key"
@@ -12,7 +17,9 @@
         :label="fileType.label"
       />
     </div>
-    <p class="mt-1 text-xs text-grey-600">None ticked: all types allowed.</p>
+    <p id="file-types-help" class="mt-1 text-xs text-grey-600">
+      None ticked: all types allowed.
+    </p>
   </div>
 
   <div class="mb-4">

From 2e16cb74aafdfdf826ca7e8e12e07c43c26cc374 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:31:05 +0200
Subject: [PATCH 11/16] fix: use plain words for the text editor's default
 placeholder

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Shared/Editor.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/js/components/Factory/Shared/Editor.vue b/resources/js/components/Factory/Shared/Editor.vue
index a078f938..f7f4349a 100644
--- a/resources/js/components/Factory/Shared/Editor.vue
+++ b/resources/js/components/Factory/Shared/Editor.vue
@@ -137,7 +137,7 @@ const {
   counter = false,
   bare = false,
   id,
-  placeholder = "Type your message here...",
+  placeholder = "Type your text…",
 } = defineProps<{
   modelValue?: string;
   counter?: boolean;

From 84d0bd9d4d9fe2941d33a85069b57fe43a829661 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:36:43 +0200
Subject: [PATCH 12/16] fix: drop the settings heading where a type has no
 settings of its own

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Factory/Document/QuestionSettings.test.ts | 20 +++++++++++++------
 .../Factory/Document/QuestionSettings.vue     | 12 +++++------
 2 files changed, 19 insertions(+), 13 deletions(-)

diff --git a/resources/js/components/Factory/Document/QuestionSettings.test.ts b/resources/js/components/Factory/Document/QuestionSettings.test.ts
index 23067a5f..09e4dc11 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.test.ts
+++ b/resources/js/components/Factory/Document/QuestionSettings.test.ts
@@ -13,9 +13,7 @@ const heading = (type: string, interactionType?: FormBlockInteractionType) =>
             } as unknown as FormBlockModel,
             interactionType,
         },
-    })
-        .find("h3")
-        .text();
+    }).find("h3");
 
 describe("the settings heading", () => {
     it.each([
@@ -26,12 +24,22 @@ describe("the settings heading", () => {
         ["scale", "range", "Scale"],
         ["date", "date", "Date"],
         ["input-file", "file", "File upload"],
-        ["consent", "consent", "Consent"],
-        ["none", undefined, "Settings"],
     ] as const)(
         "names a %s question's settings %s → %s",
         (type, interaction, text) => {
-            expect(heading(type, interaction)).toBe(text);
+            expect(heading(type, interaction).text()).toBe(text);
+            expect(heading(type, interaction).classes()).not.toContain(
+                "sr-only",
+            );
         },
     );
+
+    // their panel holds only Short name and Hide this question
+    it.each([
+        ["consent", "consent"],
+        ["none", undefined],
+    ] as const)("shows no heading for a %s question", (type, interaction) => {
+        expect(heading(type, interaction).text()).toBe("Settings");
+        expect(heading(type, interaction).classes()).toContain("sr-only");
+    });
 });
diff --git a/resources/js/components/Factory/Document/QuestionSettings.vue b/resources/js/components/Factory/Document/QuestionSettings.vue
index 0944084c..1469133d 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.vue
+++ b/resources/js/components/Factory/Document/QuestionSettings.vue
@@ -9,9 +9,9 @@
     <h3
       :id="`${id}-title`"
       class="text-xs font-semibold text-grey-600"
-      :class="sheet && 'sr-only'"
+      :class="(sheet || !heading) && 'sr-only'"
     >
-      {{ heading }}
+      {{ heading || "Settings" }}
     </h3>
 
     <ConfigureInput v-if="interactionType === 'input'" />
@@ -88,23 +88,21 @@ const props = defineProps<{
 const workbench = useWorkbench();
 const { editableInteractions } = useActiveInteractions(props.block);
 
-// named by answer type; "Text only" has no answer settings
+// named by answer type; Consent and Text only have no settings of their own,
+// so their panel shows no heading
 const headings: Partial<Record<FormBlockInteractionType, string>> = {
   button: "Choices",
   input: "Answer field",
   textarea: "Answer field",
   date: "Date",
   file: "File upload",
-  consent: "Consent",
 };
 const heading = computed(() => {
   if (props.interactionType === "range") {
     return props.block.type === "scale" ? "Scale" : "Rating";
   }
 
-  return (
-    (props.interactionType && headings[props.interactionType]) ?? "Settings"
-  );
+  return props.interactionType && headings[props.interactionType];
 });
 
 const title = ref(props.block.title ?? "");

From 4798dbf8af0f88774f08f46ad2ab791648e00c83 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:37:10 +0200
Subject: [PATCH 13/16] fix: say "a deleted question" in a rule's sentence

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../js/components/Factory/Document/Rules/BlockRules.test.ts     | 2 +-
 .../js/components/Factory/Document/Rules/DeletedQuestion.vue    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/resources/js/components/Factory/Document/Rules/BlockRules.test.ts b/resources/js/components/Factory/Document/Rules/BlockRules.test.ts
index 8eaacab0..9feb216b 100644
--- a/resources/js/components/Factory/Document/Rules/BlockRules.test.ts
+++ b/resources/js/components/Factory/Document/Rules/BlockRules.test.ts
@@ -173,7 +173,7 @@ describe("a rule under its question", () => {
         const broken = wrapper.findAll(".text-red-700");
 
         expect(broken).toHaveLength(2);
-        expect(broken[0].text()).toContain("Deleted question");
+        expect(broken[0].text()).toContain("a deleted question");
     });
 });
 
diff --git a/resources/js/components/Factory/Document/Rules/DeletedQuestion.vue b/resources/js/components/Factory/Document/Rules/DeletedQuestion.vue
index 40da58ec..167681a4 100644
--- a/resources/js/components/Factory/Document/Rules/DeletedQuestion.vue
+++ b/resources/js/components/Factory/Document/Rules/DeletedQuestion.vue
@@ -2,7 +2,7 @@
   <span
     class="inline-flex items-center gap-1 rounded bg-red-50 px-1.5 font-medium text-red-700 ring-1 ring-inset ring-red-200"
   >
-    <D9Icon name="triangle-exclamation" aria-hidden="true" />Deleted question
+    <D9Icon name="triangle-exclamation" aria-hidden="true" />a deleted question
   </span>
 </template>
 

From 0af912b4a41b6ef24784b15806c17280dfc2112c Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:38:06 +0200
Subject: [PATCH 14/16] fix: use short example placeholders in the long text
 and number settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Main/ConfigureInput.vue    | 1 -
 resources/js/components/Factory/Main/ConfigureTextarea.vue | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/resources/js/components/Factory/Main/ConfigureInput.vue b/resources/js/components/Factory/Main/ConfigureInput.vue
index 3a79c6bd..a7d6a0f9 100644
--- a/resources/js/components/Factory/Main/ConfigureInput.vue
+++ b/resources/js/components/Factory/Main/ConfigureInput.vue
@@ -19,7 +19,6 @@
       />
       <D9Input
         id="input-decimal-places"
-        placeholder="Number of decimal places"
         type="number"
         :min="0"
         :max="10"
diff --git a/resources/js/components/Factory/Main/ConfigureTextarea.vue b/resources/js/components/Factory/Main/ConfigureTextarea.vue
index 1f04bcdb..50605085 100644
--- a/resources/js/components/Factory/Main/ConfigureTextarea.vue
+++ b/resources/js/components/Factory/Main/ConfigureTextarea.vue
@@ -18,7 +18,7 @@
       />
       <D9Input
         id="textarea-rows"
-        placeholder="The size of the textarea"
+        placeholder="e.g. 4"
         type="number"
         :min="1"
         :max="10"
@@ -31,7 +31,7 @@
       <D9Label id="textarea-max-chars" label="Max characters" />
       <D9Input
         id="textarea-max-chars"
-        placeholder="The maximum number of characters"
+        placeholder="No limit"
         type="number"
         block
         v-model="maxChars"

From b2940059dcf32757dac7d351ee880e4669b74cbb Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:42:25 +0200
Subject: [PATCH 15/16] fix: show an example, not "No limit", as the max
 characters placeholder

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 resources/js/components/Factory/Main/ConfigureTextarea.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/js/components/Factory/Main/ConfigureTextarea.vue b/resources/js/components/Factory/Main/ConfigureTextarea.vue
index 50605085..bec125ec 100644
--- a/resources/js/components/Factory/Main/ConfigureTextarea.vue
+++ b/resources/js/components/Factory/Main/ConfigureTextarea.vue
@@ -31,7 +31,7 @@
       <D9Label id="textarea-max-chars" label="Max characters" />
       <D9Input
         id="textarea-max-chars"
-        placeholder="No limit"
+        placeholder="e.g. 500"
         type="number"
         block
         v-model="maxChars"

From c6354e6d2009937e028dde2e3321bf60405d01d9 Mon Sep 17 00:00:00 2001
From: Philipp Reinking <philipp@deck9.co>
Date: Tue, 13 Oct 2026 09:44:21 +0200
Subject: [PATCH 16/16] fix: start the Consent and Text only settings at the
 panel top

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../js/components/Factory/Document/QuestionSettings.test.ts | 6 +++---
 .../js/components/Factory/Document/QuestionSettings.vue     | 5 +++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/resources/js/components/Factory/Document/QuestionSettings.test.ts b/resources/js/components/Factory/Document/QuestionSettings.test.ts
index 09e4dc11..912e2696 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.test.ts
+++ b/resources/js/components/Factory/Document/QuestionSettings.test.ts
@@ -28,8 +28,8 @@ describe("the settings heading", () => {
         "names a %s question's settings %s → %s",
         (type, interaction, text) => {
             expect(heading(type, interaction).text()).toBe(text);
-            expect(heading(type, interaction).classes()).not.toContain(
-                "sr-only",
+            expect(heading(type, interaction).attributes("hidden")).toBe(
+                undefined,
             );
         },
     );
@@ -40,6 +40,6 @@ describe("the settings heading", () => {
         ["none", undefined],
     ] as const)("shows no heading for a %s question", (type, interaction) => {
         expect(heading(type, interaction).text()).toBe("Settings");
-        expect(heading(type, interaction).classes()).toContain("sr-only");
+        expect(heading(type, interaction).attributes("hidden")).toBe("");
     });
 });
diff --git a/resources/js/components/Factory/Document/QuestionSettings.vue b/resources/js/components/Factory/Document/QuestionSettings.vue
index 1469133d..081dc956 100644
--- a/resources/js/components/Factory/Document/QuestionSettings.vue
+++ b/resources/js/components/Factory/Document/QuestionSettings.vue
@@ -9,7 +9,8 @@
     <h3
       :id="`${id}-title`"
       class="text-xs font-semibold text-grey-600"
-      :class="(sheet || !heading) && 'sr-only'"
+      :class="sheet && 'sr-only'"
+      :hidden="!heading"
     >
       {{ heading || "Settings" }}
     </h3>
@@ -89,7 +90,7 @@ const workbench = useWorkbench();
 const { editableInteractions } = useActiveInteractions(props.block);
 
 // named by answer type; Consent and Text only have no settings of their own,
-// so their panel shows no heading
+// so their heading is hidden: it still names the group, and space-y skips it
 const headings: Partial<Record<FormBlockInteractionType, string>> = {
   button: "Choices",
   input: "Answer field",