---
title: Mark chat for Optimizely CMS 13
slug: cms-13/docs/mark-chat-for-optimizely-cms-13
docTags: 
createdAt: 2026-08-07T16:46:24.000Z
---

Mark chat is an AI-powered assistant that helps you research, brainstorm, create content, generate images, and optimize your marketing workflows directly within CMS 13 or through the Agent Platform website.

## Prerequisites

- You must have Optimizely Content Management System (CMS 13) hosted in Optimizely Digital Experience Platform (DXP).
- Your CMS 13 instance must be enabled for Opti ID.
- You must have Optimizely Agent Platform provisioned at the organizational level. Contact your customer success manager (CSM).
- You must allow third-party cookies.
- Install Mark chat from [NuGet](https://nuget.optimizely.com/packages/optimizely.cms.opalchat/). See [Install CMS apps](docId\:OOCr_45tX9MKylr5guNdh) and [Install Optimizely Agent Platform](docId\:gRy2gB6_7RsXu-19BSJH5).

## Mark chat user interface

See [AI in Optimizely Experimentation: Meet your infinite workforce](https://optimizely.navattic.com/mkk0w9j) for a step-by-step walkthrough of Mark chat with example prompts.

How Mark chat displays varies by entry point and conversation state. The following screenshots provide a general reference for typical layouts.

### Through the Agent Platform website

When accessing through the Agent Platform website, [mark.optimizely.com](https://mark.optimizely.com/chat), Mark displays similar to the following:

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XwIsLnkqpkV08eKRiQI3k_52e88f30d4acc207df0bf89c044ba4c79625f8cf79a4f019f2ca8473ddfb4565-image.png)

1. **Search Mark chat history** – Search one or more Mark chats.
2. **New Chat** – Start a new chat. Start a new chat when switching topics to keep Mark's responses and chat thread history focused.
3. **More options** – Click **Bulk Select** to choose multiple chat threads, then click **Delete**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/YCDznH3QLTKBUXh1rVatf_e6f35ebba260c2554ff842975f12b0858424aa7f2f1b4579d4f0fbc5c6126829-image.png)

4. **Show or hide Chat history** – Toggle the Chat history panel to show or hide.
5. **Set Product Instance** – Select the Optimizely instance that Mark should refer to.
6. **Chat history** – Go to previous chat threads with Mark.
7. **Chat thread options** – Additional options to update your chat threads, including the option to copy the chat, copy the chat ID, pin the chat to top of the sidebar, rename the thread, and delete the chat thread. You cannot retrieve deleted chats.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/WwrTRXnq0VSl0TrQ9xiQU_f81ad0441c8bfe389cbf5b58b0264cc91d3a93525a48d37e06f0080b3f54872a-image.png)

8. **Regenerate** – Have Mark respond differently to the same query.
9. **Create skills** – Create an [organization](docId\:k420spMZuO290lC-HDXfb) or [personal](docId\:us7iZ6Rvo_03yXtLw_vdr) skill based on your conversation with Mark.
10. **Copy** – Copy Mark's response to your clipboard.
11. **Give feedback on a response** – Click **Thumbs up** if Mark's response helped. Click **Thumbs down** if it did not help.
12. **Chat with Mark**
    - **Ideate and prompt** – Ask Mark to research, brainstorm, create things, provide a summary, and so on. Mark can explain terms, walk you through configuration steps, or point you to relevant documentation. It can evolve a rough idea into something more complete, such as expanding a hypothesis or completing a concept.
    - **Translate content or tone** – Translate text into other languages or rewrite content to fit a specific tone or audience.
    - **Research online** – Ask Mark to search the web, summarize content, or extract key information from provided URLs.
    - **Sample queries**
      - *Summarize this document into key takeaways.*
      - *Extract the details from this timeline and present them to me as a list.*
      - *Give me the audio text and timestamps from this file so I can copy and paste into a subtitle .mov file. Remove any "ums" and "ahs" from the text.*
      - *Develop a test plan for a web experiment comparing two different call-to-action button designs to determine which drives more user engagement.*
      - *Using Optimizely Feature Experimentation, set up a feature flag for the new checkout process and outline a strategy for its gradual rollout and A/B testing.*
      - *How should we personalize content for anonymous users versus logged-in users?*
      - *Extract the key points from this video and create a blog post to promote them.*
    - **Undo** – Press Ctrl+Z (Windows) or Cmd+Z (Mac) to undo text typed or pasted in the chat input.
13. **Add** – Upload files and ask questions about their content or add Connectors. See [Supported file types in Optimizely Agent Platform](/hc/en-us/articles/40874261840525) and [Connector tools overview](/hc/en-us/articles/40536213498253).
14. **Mention Agent** – Select an agent to run.
15. **Use skill** – Select skills to use. Enter */* and select the skill.
16. **Response speed** – Select the speed Mark takes for its response. See [Response speed options](docId\:dtNBEttEGVvkhNkwNypLM).
17. **Submit** – Submit a request to Mark. Click **Stop** at any time to end Mark's execution. See [Stop a response](docId\:dtNBEttEGVvkhNkwNypLM).

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/l4i8sR4BGBUu8Q8vp2bTI_746e8c63df995a07ba997c8479ba5f3d9d06f082a9e7fe6dcb4fb736e2bf47b7-image.png)

Messages sent while Mark is responding display as queued cards and send automatically when the current response completes. See [Queue messages while Mark works](docId\:dtNBEttEGVvkhNkwNypLM).

### In an Optimizely product

When accessing Mark through an Optimizely product by clicking a button, such as **Ask Mark**, Mark displays similar to the following:

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ZnCNF6QZoakGv1WkRrOP__f292d44815b7947d04bb84694dd4e5f9bb8e21f355edce4da69e7a4581e5c460-image.png)

1. **Search Mark chat history** – Search one or more Mark chats.
2. **New Chat** – Start a new chat thread. You should start a new chat when switching topics to keep Mark's responses focused and your chat thread history focused on the topic.
3. **More options** – Click **Bulk Select** to choose multiple chat threads, then click **Delete**.
4. **Toggle sidebar** – Show or hide the chat history sidebar.
5. **Fullscreen** – Expand the Mark chat window to take up your entire browser window.
6. **Dock to the side** – Dock the Mark chat as a panel to the side of your browser window. The icon updates to **Pop it out** when docked.
7. **Close** – Close the Mark chat window.
8. **Chat history** – Go to previous chat threads with Mark.
9. **Chat thread options** – Additional options to update your chat threads, including the option to copy the chat, copy the chat ID, pin the chat to top of the sidebar, rename the thread, and delete the chat thread. You cannot retrieve deleted chats.
10. **Add** – Upload files and ask questions about their content or add Connectors. See [Supported file types in Optimizely Agent Platform](/hc/en-us/articles/40874261840525) and [Connector tools overview](/hc/en-us/articles/40536213498253).
11. **Mention Agent** – Select an agent to run.
12. **Use skill** – Select skills to use. Enter */* and select the skill.
13. **Response speed** – Select the speed Mark takes for its response. See [Response speed options](docId\:dtNBEttEGVvkhNkwNypLM).
14. **Submit** – Submit a request to Mark. Click **Stop** at any time to end Mark's execution. See [Stop a response](docId\:dtNBEttEGVvkhNkwNypLM).

Messages sent while Mark is responding display as queued cards and send automatically when the current response completes. See [Queue messages while Mark works](docId\:dtNBEttEGVvkhNkwNypLM).

## Prompt engineering for Mark chat

Make the most of Mark by communicating your requests clearly and effectively. Prompt engineering involves crafting precise prompts to get the best results. You can boost Mark's ability to support your marketing and product development work with a few simple principles.

### Key principles of effective prompting

- **Clarity and specificity** – Just like giving instructions to a human assistant, clarity and specificity are crucial for Mark chat. Avoid vague or ambiguous language. The more precise you are with your request, the more accurate and relevant Mark's response is.
  - **Instead of** – *Tell me about marketing.*
  - **Try** – *Generate a list of content marketing strategies for ecommerce businesses targeting Gen Z.*
- **Context and background** – Provide relevant context and background information to help Mark understand your request better. This can include details about your target audience, campaign objectives, brand guidelines, or specific Optimizely functionalities you want to utilize.
  - **Instead of** – *Create a campaign brief.*
  - **Try** – *Create a campaign brief for a new product launch targeting millennials, with a budget of $10,000, focusing on social media channels, and aligning with our brand's sustainability values.*
- **Desired output format** – Specify the desired format for Mark's response, such as a list, a paragraph, a table, or code. This information helps Mark structure its output in a manner that is useful to you.
  - **Instead of** – *Analyze our A/B test results.*
  - **Try** – *Analyze the A/B test results for the homepage banner, comparing variations A and B, and provide a table summarizing the click-through rate, conversion rate, and statistical significance for each variation.*
- **Iterative refinement** – Do not expect the perfect response on the first try. Prompt engineering is an iterative process. Start with a general prompt, then refine it based on Mark's initial response. Experiment with different phrasings, keywords, and levels of detail to fine-tune the output.
- **Examples and demonstrations** – Provide examples or demonstrations of the desired output to improve Mark's understanding. You can refer to past campaigns, content pieces, or reports as templates for Mark.
  - **Instead of** – *Write a blog post about A/B testing.*
  - **Try** – *Write a blog post about A/B testing, similar in style and tone to the example provided in this link: \[link to example blog post]. Focus on the benefits of A/B testing for Optimizely Experimentation users.*

### Tips for effective prompting

- Be clear and specific in your requests.
- Provide context and background information.
- Use examples to illustrate the desired output.
- Break down complex tasks into smaller, more manageable steps.

### Example prompts for CMS (SaaS)

- *Generate a draft blog post about the advantages of a cloud-native CMS for improving website performance and scalability.*
- *Analyze the SEO performance of the 'Solutions' landing page (provide URL) and suggest improvements for meta titles, descriptions, and target keywords.*
- *Create a new content type for 'Case Studies' in CMS (SaaS). Include fields for client name, industry, challenge, solution, results, and a featured image.*
- *Suggest 3 variations for a hero banner headline on our homepage, focusing on communicating our unique value proposition for a SaaS product.*
- *I need to update our product feature descriptions. Can you help me rephrase this technical explanation into more benefit-driven language for our users? (provide text).*
- *What are the best practices for managing content governance and compliance within Optimizely CMS (SaaS)?*
- *Generate a series of social media posts (for Twitter, LinkedIn, and Instagram) promoting our latest product update, based on this release notes draft (provide text).*
- *Create a set of tasks in CMP for launching a new content marketing initiative, including content planning, creation, review, and publishing steps. The initiative's goal is to drive sign-ups for our free trial.*
- *Help me write a compelling call-to-action for a demo request form, aiming to increase lead generation.*
- *Can you provide a summary of how Optimizely CMS (SaaS) integrates with other Optimizely products like Web Experimentation and Personalization?*
- *I'm looking to optimize content for different audience segments. What are some strategies for content personalization using CMS (SaaS) capabilities?*
- *Suggest improvements for the readability and visual appeal of this long-form article about industry trends (provide content/URL), ensuring it's engaging for mobile users.*

### Image features in Mark chat

Use Mark chat to create original images or make changes to existing ones by sending a request with a prompt and optional settings.

### Create images

To generate a new image, send Mark a prompt describing what you want to create. You can also include the following optional parameters to customize the result:

- **Prompt** – Description of the image you want to generate. More detail leads to better results.
- **Aspect ratio** – Shape of the generated image. If not specified, Mark uses 1:1. Choose from the following:
  - **1:1 (Square)** – Good for profile pictures or Instagram posts.
  - **4:3 (Standard landscape)** – Common for older TVs or digital cameras.
  - **16:9 (Widescreen landscape)** – Standard for modern TVs, YouTube videos, and presentations.
  - **9:16 (Vertical portrait)** – Ideal for Instagram Stories, TikTok, and mobile content.
- **Number of images** – Total number of image variations to generate. You can request up to four. If you do not specify, Mark generates one.

:::hint{type="info"}
**Note**
Be as specific as possible in your prompt to get the best results. Include details like style, lighting, background, or mood.
:::

**Example prompt** – *Using the brand knowledge you have for Optimizely, create three images for a header image for a blog on Optimizely.com about Optimizely Agent Platform?*

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/RPqgje3oLyub79mGZlMG5_07d5ccfb68ea3057f8aac12f76ad5d0dcf698d6c15b80bad79e25c1718b1eeda-image.png)

Click **Regenerate** to create a new set of images. You can also prompt Mark to adjust the images it created.

## Edit images

With Mark chat, you can edit images by linking to their URL. In your request, you can include the following parameters:

- **Image URL** – Link to the image you want Mark to edit.
- **Prompt** – Instructions for how you want Mark to edit the image. Be as specific as possible. For example, you can ask Mark the following:
  - Add or remove objects.
  - Change the background.
  - Change the aspect ratio.
  - Adjust colors, lighting, or composition.
  - Change the style or mood.
- **Number of images** – Total variations of the edited image to generate. You can request up to four.

**Example prompt** – *Edit the image: LINK\_TO\_IMAGE. Update the style to cartoonish, change the mood to be happier, and give 4 variations.*