DEVDOCS-6035: [update] geography nodes

docs/storefront/graphql/examples/index.mdx

@@ -251,3 +251,43 @@ Analytics IDs are available only after configuring the analytics service provide
 ```
 
 <a href="https://developer.bigcommerce.com/graphql-storefront/playground" target="_blank">**Try it in GraphQL Playground**</a>
+
+## Get a list of countries
+
+The `geography` node provides a list of all supported shipping countries and their corresponding states or provinces. By default, the full list is returned unless you apply a filter. To narrow down the list, you can use the **Settings** > **Shipping** >  **Checkout shipping options** filter in the control panel. This filter limits the results to only those countries included in your active shipping zones.
+
+```graphql filename="Example query: Get list of countries" showLineNumbers copy
+ {
+  site {
+    settings {
+      shipping {
+        supportedShippingDestinations {
+          countries { # same schema as geography node, but implicitly filtered
+            entityId
+            code
+            name
+            statesOrProvinces {
+              entityId
+              name
+              abbreviation
+            }
+          }
+        }
+      }
+    }
+  }
+  geography { # geography node is available at the top level still for unfiltered use
+    countries {
+      entityId
+      code
+      name
+      statesOrProvinces {
+        entityId
+        name
+        abbreviation
+      }
+    }
+  }
+}
+```
+<a href="https://developer.bigcommerce.com/graphql-storefront/playground" target="_blank">**Try it in GraphQL Playground**</a>