From 3a07a8224a0f84eff6220de92d8af059c7baefac Mon Sep 17 00:00:00 2001
From: Luke Eller <luke.eller@bigcommerce.com>
Date: Thu, 25 Sep 2025 15:53:42 +1000
Subject: [PATCH] BACK-288 - Document backorder settings

---
 reference/settings.v3.yml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/settings.v3.yml b/reference/settings.v3.yml
index 051d31e03..846aa5e63 100644
--- a/reference/settings.v3.yml
+++ b/reference/settings.v3.yml
@@ -2089,6 +2089,15 @@ components:
           description: Describes whether out-of-stock messages are shown on product listing pages.
           default: false
           example: true
+        backorder_availability_prompt:
+          type: string
+          description: Message that appears on the product detail page to reassure shoppers of backorder availability.
+          example: "This item is currently on backorder but will be available soon!"
+        show_backorder_availability_prompt:
+          type: boolean
+          description: Whether or not to show the backorder availability prompt on product detail pages.
+          default: false
+          example: true
     Locale:
       description: 'The basic locale settings for a store, used to give shopper information about languages, countries, etc.'
       type: object