Update each Maia Make feature doc to reflect the 11.9 release

Yiyun333 · Yiyun333 · commit 6c5f09ecb1ee · 2026-03-27T16:17:17.000+01:00
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md
@@ -15,21 +15,28 @@ Maia Make capabilities are grouped into a conversational interface, which is ava
 To use this interface and Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-Maia Make is a set of AI-assisted development capabilities in Studio Pro that are available through a unified conversational interface. Describe your requirements in natural language, and Maia generates development artifacts such as data structures, overview pages, and microflows. 
+Maia Make is a set of AI-assisted development capabilities in Studio Pro that are available through a unified conversational interface. Describe your requirements in natural language, and Maia generates development artifacts such as data structures, pages, and microflows. 
 
-You can also ask Maia to provide explanations of your existing logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by generating app artifacts based on existing user stories.
+You can also ask Maia to provide explanations of your existing documents, such as logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by generating app artifacts based on existing user stories.
 
 The key Maia Make capabilities are as follows:
 
 * Conversational assistance for general Mendix development queries
-* Logic and page explanations to clarify existing implementation details
-* Domain model generation from natural language descriptions
-* Overview page generation from natural language descriptions
-* Microflow generation including XPath constraints and expressions
-* External tool integration via compatible MCP Servers (such as Playwright, Figma)
+* Explanations of documents to clarify existing implementation details
+* Generation of documents from natural language descriptions, including domain model, pages, and logic
+* Integration with external tools  via compatible MCP Servers (such as Playwright and Figma)
 * Story-based development to help realize existing user stories
-* PDF and image support to help Maia understand your requirements better
-* Add relevant logic and pages to the interface to give Maia a more desired context
+* Support for PDF and image inputs to help Maia better understand your requirements
+* Adding relevant documents (for instance, logic or pages) to the interface to give Maia a more desired context
+* Editing existing documents, including renaming documents and document elements such as entities, attributes, and microflow parameters
+* Removing elements from documents, enabling more advanced refactoring (Studio Pro 11.9 and above)
+* Undoing changes generated on a per-document basis (in Studio Pro 11.9 and above)
+
+{{% alert color="info" %}}
+Support for workflows, view entities, enumerations, constants, modules, Java actions, JavaScript actions was introduced in Studio Pro 11.9. 
+
+Java actions and JavaScript actions are read-only. Java actions can be used in microflows and can be explained. JavaScript actions can only be explained. 
+{{% /alert %}}
 
 ## Using Maia Make Capabilities
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md
@@ -33,12 +33,14 @@ See below a list of Maia Chat's data sources:
 * [Mendix Blog](https://www.mendix.com/blog/)
 * [Mendix Medium](https://medium.com/mendix)
 * [Mendix Evaluation Guide](https://www.mendix.com/evaluation-guide/)
- 
-## Using Maia Chat in Studio Pro
 
-{{% alert color="info" %}}
+## Using Maia Chat
+
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia Chat is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Chat. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, there are two ways to access Maia Chat in Studio Pro:
 
@@ -55,7 +57,7 @@ For more information on Maia Chat features in Studio Pro, see the sub-sections b
 
 If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can not get a good answer, please see the [Giving Feedback](#feedback) section below for information on how to let Mendix know.
 
-### Maia Chat Features in Studio Pro
+#### Maia Chat Features in Studio Pro
 
 After a question is sent to Maia Chat, you will see the following in the chat interface:
 
@@ -67,7 +69,7 @@ After a question is sent to Maia Chat, you will see the following in the chat in
 * A copy icon ({{% icon name="copy" %}}) which allows you to copy the given answer to a clipboard
 * Feedback icons
 
-#### Giving Feedback {#feedback}
+##### Giving Feedback {#feedback}
 
 Mendix encourages giving feedback on the answers generated by Maia Chat. Feedback will be used to further improve Maia Chat.
 
@@ -82,15 +84,15 @@ There are several ways to give feedback on the generated answer:
     * You can also provide **Additional feedback** if you want to.
     * Remember to click **Submit feedback** to submit your feedback. Afterwards, you will be brought back to the main chat interface where you can continue asking questions.
 
-#### Asking Follow-Up Questions
+##### Asking Follow-Up Questions
 
 Maia Chat supports asking follow-up questions based on your previous question and the answer you have received. For example, you can ask it to summarize the latest answer you received by typing the following in the chat: *Can you summarize that?*.
 
 {{% alert color="info" %}}
 Maia Chat will lose track of the conversation history if you exit Studio Pro.
 {{% /alert %}}
 
-#### New Chat
+##### New Chat
 
 There is a **New chat** option at the top left of the chat interface. It allows you to clear the messages and start a new conversation which does not reference your current chat.
  
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md
@@ -12,18 +12,20 @@ description: "Describes the features in Maia Explain."
 To use Maia Explain, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-## Using Maia Explain in Studio Pro 11.8 and Above
+## Using Maia Explain
+
+### In Studio Pro 11.8 and Above
 
 In Studio Pro 11.8 and above, Maia Explain is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Explain. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
 
 There are two ways to use Maia Explain:
 
-* Use the chat interface directly to get explanations of your microflows or pages.
-* In the App Explorer, right-click a microflow or a page to open its context menu, and click **Maia Explain**.
+* Use the chat interface directly to get explanations of your document (for instance, a microflow or a page).
+* In the App Explorer, right-click a document to open its context menu, and click **Maia Explain**.
 
 Nanoflows are not supported by Maia Explain in Studio Pro 11.8.
 
-## Using Maia Explain in Studio Pro 11.7 and Below
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox.
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md
@@ -18,9 +18,11 @@ Maia for Domain Model helps you generate new [domain model](/refguide/domain-mod
 
 ## Using Maia for Domain Model
 
-{{% alert color="info" %}}
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia for Domain Model is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Domain Model. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, Maia for Domain Model is enabled by default. You can find it in the the toolbar of a domain model:
 
@@ -44,7 +46,7 @@ Maia for Domain Model does not support deleting items in the domain model. You c
 In this dedicated chat, only requests related to domain model will be properly handled. If you have other questions, close this chat and go back to the general [Maia Chat](/refguide/maia-chat/) interface.
 {{% /alert %}}
  
-### Best Practices for Text Input
+#### Best Practices for Text Input
 
 To achieve optimal results, provide context about your application by describing its main use cases, customer needs, or other relevant details. The more Maia knows about your application, the more tailored and accurate the generated domain model will be.
 
@@ -64,7 +66,7 @@ Below are examples of prompts you can use to ask Maia for explanations or sugges
 * I want to make the domain model more efficient. Can you suggest optimizations?
 * Could you identify any potential issues with this domain model and recommend solutions?
 
-### Attachment Requirements {#attachment-requirements}
+#### Attachment Requirements {#attachment-requirements}
 
 In Studio Pro 11.1 and above, Maia for Domain Model supports adding a maximal of one image and one PDF as attachments. The attachments must meet the following requirements:
 
@@ -73,17 +75,12 @@ In Studio Pro 11.1 and above, Maia for Domain Model supports adding a maximal of
 * The image resolution must be no greater than 3840 × 2400 pixels.
 * The PDF file size must not exceed 1024 KB.
 
-## Limitations {#limitation}
-
-Maia for Domain Model has some limitations.
-
-### Enumeration Generation
-
-It can only generate an attribute of type Enumeration if there is an existing enumeration in the module to refer to.
+#### Limitations {#limitation}
 
-### Generalization Not Supported
+Maia for Domain Model has the following limitations:
 
-It cannot set [generalization](/refguide/generalization-and-association/) for an entity.
+* It can only generate an attribute of type Enumeration if there is an existing enumeration in the module to refer to.
+* It cannot set [generalization](/refguide/generalization-and-association/) for an entity.
 
 ## Read More
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-oql.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-oql.md
@@ -1,7 +1,7 @@
 ---
 title: "Maia for OQL"
 url: /refguide/maia-for-oql/
-weight: 70
+weight: 78
 description: "Describes the features in Maia for OQL Generation."
 ---
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md
@@ -18,9 +18,15 @@ Maia for Pages helps you generate a [page](/refguide/page/) by adding and config
 
 ## Using Maia for Pages
 
-{{% alert color="info" %}}
+### In Studio Pro 11.8 and Above
+
 In Studio Pro 11.8 and above, Maia for Pages is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Pages. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
-{{% /alert %}}
+
+In Studio Pro 11.8, only overview pages can be generated.
+
+In Studio Pro 11.9 and above, custom pages can be generated from scratch and  modifying existing pages is also supported. Moreover, local variables, additional data sources, client actions, XPath constraints, and expressions are supported.
+
+### In Studio Pro 11.7 and Below
 
 In Studio Pro 11.7 and below, to enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
 
@@ -46,7 +52,7 @@ On pages that have already been created, either by Maia for Pages or manually, y
 In this dedicated chat, only requests related to Pages will be properly handled. If you have other questions, close this chat and go back to the general [Maia Chat](/refguide/maia-chat/) interface.
 {{% /alert %}}
 
-### Best Practices for Text Input
+#### Best Practices for Text Input
 
 To achieve optimal results, provide context about your page by describing its main use cases, customer needs, or other relevant details. The more Maia knows about your page, the more tailored and accurate the generated page will be.
 
@@ -68,13 +74,13 @@ Below are examples of prompts you can use to ask Maia to make further edits or r
 * How can I make this page more user-friendly or visually appealing?
 * Could you suggest ways to optimize the performance of this page?
 
-### Best Practices for Image Input
+#### Best Practices for Image Input
 
 The image size is limited to 512 KB. Make sure to select a clear image to help Maia better understand your request. For example, you can provide a screenshot, a photo, a design mock-up, or a close-up picture of a drawing. Avoid heavily compressed or low quality images, as these may result in the loss of important details.
 
 Keep in mind that Maia analyzes only the structure of the image. The theming of your app, such as the color scheme, will not be changed. This can cause some differences between the provided image and the generated page.
 
-## Limitation {#limitation}
+### Limitation {#limitation}
 
 Maia for Pages does not support all widgets. 
 
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows.md
@@ -74,17 +74,17 @@ For example, Maia for Workflows can analyze a BPMN image representing employee o
 
 Make sure to select a clear image to help Maia better understand your request. For example, you can provide a screenshot, a photo, BPMN schema, or a close-up picture of a drawing. Avoid heavily compressed or low quality images, as these may result in the loss of important details.
 
-## Limitations {#limitation}
+### Limitations {#limitation}
 
 Maia for Workflows has some limitations.
 
-### Empty Workflows Only
+#### Empty Workflows Only
 
 Maia for Workflows is currently intended only for use with empty Workflows. Using it on existing workflows can result in incorrectly modeled business processes.
 
 Requests for improvements and explanations currently only work within the same session where a workflow has been generated. Once the session is closed, Maia for Workflows loses the context. Any attempts to make changes to that workflow in a new session will also result in the removal of all existing elements.
 
-### Supported Workflow Elements
+#### Supported Workflow Elements
 
 Currently, annotations are not supported. However, most of the other workflow elements are supported. See below a list of supported workflow elements:
 
@@ -99,7 +99,7 @@ Currently, annotations are not supported. However, most of the other workflow el
 * [Call Workflow](/refguide/call-workflow/)
 * [Boundary Events](/refguide/workflow-boundary-events/)
 
-### Not All Properties Can Be Configured
+#### Not All Properties Can Be Configured
 
 Due to the complex cross-document nature of a workflow, not all properties of the workflow elements can be generated yet. The following properties cannot be configured yet:
 
