diff --git a/reference/catalog/categories_catalog.v3.yml b/reference/catalog/categories_catalog.v3.yml
index cefe44baa..102f544a7 100644
--- a/reference/catalog/categories_catalog.v3.yml
+++ b/reference/catalog/categories_catalog.v3.yml
@@ -1432,16 +1432,20 @@ paths:
         Returns a list of products and their sort order for a specific category.
 
         **Limits**
-        * page=2&limit=250 will return page 2 of the results with 250 items per page.
+        
+        - page=2&limit=250 will return page 2 of the results with 250 items per page.
 
         **Usage Notes**
+        
+        * Product sort order only takes effect on the storefront when sorting by **Featured Items** in the category. See [Sort Order](https://support.bigcommerce.com/s/article/Sort-Order) for more information.
         * Data pairs are displayed in ascending order based on products' `sort_order` values.
         * `null` values are allowed for products without specified `sort_order` values.
         * Products with `sort_order` value of `null` will be displayed after products with valid numerical values.
         * The priorities for determining product sort order on a storefront are the following:
-          - Priority 1: Manually specified sort order on Category Level (API).
-          - Priority 2: Manually specified sort order on Product (Global) Level (UI/API).
-          - Priority 3: Default sorting by Product ID (newly added products go first) (UI/API).
+            * Priority 1: Manually specified sort order on Category Level (API).
+            * Priority 2: Manually specified sort order on Product (Global) Level (UI/API).
+            * Priority 3: Default sorting by Product ID (newly added products go first) (UI/API).
+            
       operationId: getCategorySortOrders
       responses:
         '200':
@@ -2072,7 +2076,7 @@ components:
           minimum: 0
           type: integer
           example: 4
-      description: The relative priority of the product among other products inside the category.
+          description: The relative priority of the product among other products inside the category.
       x-internal: false
     Category:
       x-tags: