diff --git a/documentation/user/en/use/api/example/imperative-catalog-schema-definition.graphql b/documentation/user/en/use/api/example/imperative-catalog-schema-definition.graphql
index 736cbf1e0..f5d6c8ca9 100644
--- a/documentation/user/en/use/api/example/imperative-catalog-schema-definition.graphql
+++ b/documentation/user/en/use/api/example/imperative-catalog-schema-definition.graphql
@@ -1,6 +1,18 @@
 mutation {
   updateCatalogSchema(
     mutations: [
+      # first create stubs of the entity schemas that the product will reference
+      {
+        createEntitySchemaMutation: {
+          entityType: "Brand"
+        }
+      },
+      {
+        createEntitySchemaMutation: {
+          entityType: "Category"
+        }
+      },
+
       {
         createEntitySchemaMutation: {
           entityType: "Product"
diff --git a/documentation/user/en/use/api/example/imperative-catalog-schema-definition.rest b/documentation/user/en/use/api/example/imperative-catalog-schema-definition.rest
index 8fb2aa4cf..6f9d0f971 100644
--- a/documentation/user/en/use/api/example/imperative-catalog-schema-definition.rest
+++ b/documentation/user/en/use/api/example/imperative-catalog-schema-definition.rest
@@ -2,6 +2,17 @@ PUT /rest/evita/schema
 
 {
   "mutations": [
+    // first create stubs of the entity schemas that the product will reference
+    {
+      "createEntitySchemaMutation": {
+        "entityType": "Brand"
+      }
+    },
+    {
+      "createEntitySchemaMutation": {
+        "entityType": "Category"
+      }
+    },
     {
       "createEntitySchemaMutation": {
         "entityType": "Product"
diff --git a/documentation/user/en/use/api/example/imperative-schema-definition.cs b/documentation/user/en/use/api/example/imperative-schema-definition.cs
index 2ff80aba3..cbeb25e4a 100644
--- a/documentation/user/en/use/api/example/imperative-schema-definition.cs
+++ b/documentation/user/en/use/api/example/imperative-schema-definition.cs
@@ -1,6 +1,11 @@
 evita.UpdateCatalog(
 	"evita",
 	session => {
+
+	    /* first create stubs of the entity schemas that the product will reference */
+        session.DefineEntitySchema("Brand");
+        session.DefineEntitySchema("Category");
+
 		session.DefineEntitySchema("Product")
 			/* all is strictly verified but associated data
 			   and references can be added on the fly */
diff --git a/documentation/user/en/use/api/schema-api.md b/documentation/user/en/use/api/schema-api.md
index 1abf2291d..920e788fb 100644
--- a/documentation/user/en/use/api/schema-api.md
+++ b/documentation/user/en/use/api/schema-api.md
@@ -156,7 +156,7 @@ at the `https://your-server:5555/gql/evita/schema` URL:
 
 or update the schema of a specific entity collection at the same URL using a GraphQL mutation of the selected collection like this:
 
-<SourceCodeTabs requires="/documentation/user/en/get-started/example/complete-startup.java,/documentation/user/en/get-started/example/define-test-catalog.java" langSpecificTabOnly local>
+<SourceCodeTabs requires="/documentation/user/en/use/api/example/imperative-schema-definition.java" langSpecificTabOnly local>
 
 [Imperative collection schema definition via GraphQL API](/documentation/user/en/use/api/example/imperative-collection-schema-definition.graphql)
 </SourceCodeTabs>
@@ -196,7 +196,7 @@ at the `https://your-server:5555/rest/evita/schema` URL:
 or update the schema of a specific entity collection at e.g. an `https://your-server:5555/rest/evita/product/schema` URL
 for the collection `Product` using a REST mutation of the selected collection like this:
 
-<SourceCodeTabs requires="/documentation/user/en/get-started/example/complete-startup.java,/documentation/user/en/get-started/example/define-test-catalog.java" langSpecificTabOnly local>
+<SourceCodeTabs requires="/documentation/user/en/use/api/example/imperative-schema-definition.java" langSpecificTabOnly local>
 
 [Imperative collection schema definition via REST API](/documentation/user/en/use/api/example/imperative-collection-schema-definition.rest)
 </SourceCodeTabs>