diff --git a/packages/module/patternfly-docs/content/extensions/chatbot/design-guidelines.md b/packages/module/patternfly-docs/content/extensions/chatbot/design-guidelines.md
index f80adee5f..b47369600 100644
--- a/packages/module/patternfly-docs/content/extensions/chatbot/design-guidelines.md
+++ b/packages/module/patternfly-docs/content/extensions/chatbot/design-guidelines.md
@@ -88,6 +88,7 @@ The following actions can be used for some of the most common interactions:
1. **Feedback (good response):** Applies a positive rating to the message.
1. **Feedback (bad response):** Applies a negative rating to the message.
1. **Copy:** Copies the message content to the clipboard.
+1. **Download:** Downloads the chat message. [Learn more about downloading chat transcripts](#downloading-chat-transcripts).
1. **Listen:** Reads the message content out loud.
You can also use [custom message actions](/patternfly-ai/chatbot/messages#custom-message-actions) as needed for your particular use case. When using custom actions, be sure to add a tooltip that describes the effect that the action will have. For more information, view [our tooltips guidelines](/ux-writing/tooltips).
@@ -340,6 +341,38 @@ If a message attachment fails, an error message should share the reason for fail
+### Downloading chat transcripts
+
+You can enable users to download chat transcripts, for their personal records or to share with others. When users choose to download a transcript, you can choose how you want to configure the behavior in your ChatBot.
+
+For guidance, refer to our download transcripts demo, which opens a Markdown file for a conversation within a new tab.
+
+Choose the download action location that best works for your ChatBot:
+
+#### Download via conversation history drawer
+
+If your ChatBot uses a conversation history drawer, you can provide a download option in the [actions menu linked to a previous conversation](/patternfly-ai/chatbot/ui#drawer-with-conversation-actions).
+
+
+
+
+
+#### Download message response action
+
+To allow users to download individual bot messages, the message actions can include a download option.
+
+
+
+
+
+#### Download control in header
+
+If you don't use a conversation history drawer, you can place an option to download the transcript for the active chat within the header options menu.
+
+
+
+
+
## Variations
### Display modes
@@ -400,4 +433,4 @@ For guidance on writing ChatBot content, refer to our [conversation design guide
## Accessibility
-Although accessibility has been integrated into the design of our ChatBot components, it is important to ensure that your implementation is inclusive of all users. For more guidance, refer to [our accessibility guidelines](/accessibility/about-accessibility).
+Although accessibility has been integrated into the design of our ChatBot components, it is important to ensure that your implementation is inclusive of all users. For more guidance, refer to [our accessibility guidelines](/accessibility/about-accessibility).
\ No newline at end of file
diff --git a/packages/module/patternfly-docs/content/extensions/chatbot/img/chatbot-elements.svg b/packages/module/patternfly-docs/content/extensions/chatbot/img/chatbot-elements.svg
index aee6b1a78..991930d32 100644
--- a/packages/module/patternfly-docs/content/extensions/chatbot/img/chatbot-elements.svg
+++ b/packages/module/patternfly-docs/content/extensions/chatbot/img/chatbot-elements.svg
@@ -3,69 +3,71 @@
-
-
-
-
-
-
-
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
+
+
+
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
-
-
+
+
-
+
@@ -79,7 +81,7 @@
-
+
@@ -95,8 +97,8 @@
-
-
+
+
@@ -110,11 +112,11 @@
-
+
-
+
@@ -122,13 +124,13 @@
-
+
-
+
-
+
diff --git a/packages/module/patternfly-docs/content/extensions/chatbot/img/conversation-history.svg b/packages/module/patternfly-docs/content/extensions/chatbot/img/conversation-history.svg
index 1140f48a5..e20c3f99e 100644
--- a/packages/module/patternfly-docs/content/extensions/chatbot/img/conversation-history.svg
+++ b/packages/module/patternfly-docs/content/extensions/chatbot/img/conversation-history.svg
@@ -1,100 +1,44 @@
-