diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_adding_prompt_project_settings.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_adding_prompt_project_settings.png
new file mode 100644
index 00000000..11102d13
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_adding_prompt_project_settings.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_advanced.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_advanced.png
new file mode 100644
index 00000000..5fc85064
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_advanced.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_basic.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_basic.png
new file mode 100644
index 00000000..6c160f0c
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_prompt_basic.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_provider.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_provider.png
new file mode 100644
index 00000000..3f55f7a5
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_configuring_provider.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor.png
new file mode 100644
index 00000000..fb0d0cc3
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor_settings.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor_settings.png
new file mode 100644
index 00000000..92b276a0
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_editor_settings.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_pre_translate_ai.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_pre_translate_ai.png
new file mode 100644
index 00000000..ba23dd76
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_pre_translate_ai.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompt_actions.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompt_actions.png
new file mode 100644
index 00000000..12afdbf3
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompt_actions.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompts_list.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompts_list.png
new file mode 100644
index 00000000..27a94fe0
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_prompts_list.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_settings.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_settings.png
new file mode 100644
index 00000000..f1b0f724
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_settings.png differ
diff --git a/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_top_up_balance.png b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_top_up_balance.png
new file mode 100644
index 00000000..f97ed2d7
Binary files /dev/null and b/src/content/docs/crowdin/translation-process/_assets/crowdin_ai_top_up_balance.png differ
diff --git a/src/content/docs/crowdin/translation-process/crowdin-ai.mdx b/src/content/docs/crowdin/translation-process/crowdin-ai.mdx
index 07cf44fa..e5c5cbfe 100644
--- a/src/content/docs/crowdin/translation-process/crowdin-ai.mdx
+++ b/src/content/docs/crowdin/translation-process/crowdin-ai.mdx
@@ -5,4 +5,333 @@ sidebar:
order: 1
---
-https://support.crowdin.com/crowdin-ai/
+[//]: # (https://support.crowdin.com/crowdin-ai/)
+
+import { Steps, Aside, LinkCard } from '@astrojs/starlight/components';
+import { Icon } from 'astro-icon/components';
+import ReadMore from '~/components/ReadMore.astro';
+
+import { Image } from 'astro:assets';
+import aiAssistantEditorSettings from "./_assets/crowdin_ai_editor_settings.png";
+
+Crowdin integrates with top AI providers, including OpenAI, Google Gemini, Microsoft Azure OpenAI, and more, allowing you to leverage advanced AI-powered translations that consider additional context at different levels. These translations can be applied to your content with a few clicks using [pre-translation via AI](#pre-translation-via-ai). Additionally, AI in Crowdin can be used as an [assistant in the Editor](#using-ai-in-the-editor) for translation, proofreading, and more.
+
+You can expand your AI provider options by installing respective applications from the Crowdin [Store](https://store.crowdin.com/tags/ai).
+
+## Configuring AI
+
+Crowdin AI integration provides powerful capabilities for enhancing localization workflows. Configuring AI involves [setting up providers](#configuring-ai-providers) and [creating prompts](#configuring-ai-prompts).
+
+### Configuring AI Prompts
+
+Prompt engineering is crucial for guiding AI in understanding context and providing accurate translations. Customizing prompts within Crowdin ensures that AI algorithms comprehend the nuances of your project, resulting in improved translation quality.
+
+* **Contextual Prompts** – customize prompts to provide contextual information, such as project-specific terminology, style preferences, and target audience considerations. For example, include instructions on translating technical terms consistently or maintaining brand tone across languages.
+* **Placeholder Utilization** – incorporate placeholders to dynamically insert context-specific information into prompts, enabling AI to generate translations aligned with project requirements.
+* **File-Level Context** – use file-level context to provide instructions and contextual insights, enhancing AI's understanding of content nuances. Include file descriptions, summaries, or references to glossaries and style guides.
+
+To configure AI prompts, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Prompts** tab, click **Add prompt**. Alternatively, you can go ahead with creating prompt samples clicking **Try a sample**. Crowdin allows you to quickly set up pre-configured prompts that are ready to perform effectively from the moment they are created. While these samples are designed to work good initially, you can customize them to your personal preferences.
+
+ 3. In the appeared dialog, set the prompt parameters:
+ * Select **Enabled**
+ * Select the prompt type (i.e., Pre-translate or AI in editor)
+ * Title
+ * AI Provider
+ * AI Model
+ * Use this prompt as the default prompt for AI in editor (Specific to the AI in editor prompt type)
+ * Mode (i.e., Basic or Advanced)
+ * Additional context (Basic mode) – specify which data will be included in the prompt using the following fields:
+ * Company description
+ * Project description
+ * Audience description
+ * String context
+ * String identifier (key)
+ * Translation max. length
+ * Other languages translations – select specific language tranlations to be considered by AI as additional context or leave this field as is to use translations from all languages.
+ * Glossary terms – allows AI to consider domain glossary terms.
+ * TM suggestions – allows AI to consider TM suggestions.
+ * File content – allows AI to consider a whole file as the context for translating a segment of strings, improving translation accuracy for text documents. Although, when using file content as an additional context it can lead to increased token usage, potentially resulting in additional costs.
+ * File context – allows AI to consider a textual description of the file added in the file settings. Read more about [File context](/files-management/#file-context).
+ * Screenshots – allows AI to consider a visual context in the form of screenshots where the strings are tagged. This enhances accuracy and context awareness. Read more about [Screenshots](/screenshots).
+ * Public project description – allows AI to consider public project description.
+ 
+ * Advanced mode – click **Advanced mode** to compose your prompt in the most precise way. While composing your prompt in the Advanced mode, you can increase translation quality by leveraging context information in your prompts using the following placeholders:
+ * `%sourceLanguage%` – The source language of a project.
+ * `%targetLanguage%` – The target languages a project is translated into.
+ * `%json%` – A collection of strings from the current segment, including the string identifier (key), context, text, maximum length, and translations to other languages (if the translations placeholder is specified).
+ * `%fileName%` – The file name of the current segment.
+ * `%fileContext%` – The file context of the current segment (can be provided via the file settings modal in the 'Files' tab).
+ * `%fileContent%` – The source file content of the current segment.
+ * `%tm%` – Translation Memory (TM) matches relevant to the current segment.
+ * `%terms%` – All the glossary terms relevant to the current segment.
+ * `%fileTranslations%` – Translations of the current segment into the specified language.
+ * `%projectName%` – Crowdin project name.
+ * `%projectPublicDescription%` – Project public description.
+ 
+ * Visibility – select specific projects where a prompt can be used or leave this field as is to allow a prompt usage across all projects.
+
+ 4. Click **Create**.
+
+
+### Managing AI Prompts
+
+Managing AI prompts in Crowdin involves various operations such as filtering and searching, editing, cloning, and deleting AI prompts. Below you can find instructions for each operation.
+
+#### Viewing and Searching AI Prompts
+
+Once you open the **AI** page, you can view and search for prompts in the **Prompts** tab.
+
+You can view the list of added prompts (one prompt per row) with the following details:
+
+* Title
+* Visibility
+* Type
+* Status
+
+By default, all prompts are displayed in the **Prompts** tab. To filter prompts displayed, click and use the available filter options:
+
+* Type: All, AI in editor, Pre-translate.
+* Status: All, Enabled, Disabled.
+
+To search for a particular prompt, type its title in the **Search** field.
+
+
+
+#### Editing AI Prompts
+
+If you need to fine-tune your already configured prompt, you can simply edit it.
+
+To edit AI prompts, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Prompts** tab, click toward the needed prompt and select **Edit**.
+
+ 3. Modify the prompt as needed and click **Update** to save changes.
+
+
+Editing prompts allows you to update and improve them as needed to ensure they remain effective and aligned with your requirements. If you don't want to lose the current prompt configuration and are uncertain about the changes, consider [cloning](#cloning-ai-prompts) your prompt and experimenting with the copy.
+
+#### Cloning AI Prompts
+
+Cloning AI prompts allows you to experiment with and refine prompt configurations without altering the original. This feature is particularly useful for testing improved versions of prompts while preserving the initial setup.
+
+To clone AI prompts, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Prompts** tab, click toward the needed prompt and select **Clone**.
+
+ 3. As a result, a copy of the prompt will appear in the prompt list.
+
+
+You can then [edit](#editing-ai-prompts) the cloned prompt to experiment with different configurations. This allows you to safely test enhancements and optimize performance without risking the loss of the original prompt configuration.
+
+#### Deleting AI Prompts
+
+Deleting AI prompts is a straightforward process, but it should be done with caution to avoid losing valuable configurations. This action is useful when you no longer need a specific prompt or want to clean up unused prompts.
+
+To delete AI prompts, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Prompts** tab, click toward the needed prompt and select **Remove**.
+
+ 3. Confirm the deletion.
+
+
+
+
+
+
+### Configuring AI Providers
+
+Crowdin supports various AI providers, each offering unique models and features for translation tasks. By configuring providers, you can tailor AI functionality to suit your specific localization needs. Whether using managed by Crowdin services or integrating your own API keys, Crowdin enables seamless integration with AI services.
+
+In the **Providers** tab, you can view the list of providers with the following details:
+
+* Title
+* Status: Enabled, Disabled.
+* Managed by Crowdin: yes, no.
+* Prompts count: if there are one or more prompts configured with a particular provider, you'll see the actual number of prompts, otherwise you'll see the **Create** button that redirects to the prompt creation dialog.
+
+Currently, Crowdin supports the following AI providers:
+
+* OpenAI
+* Google Gemini
+* Microsoft Azure OpenAI
+* Mistral AI
+* Anthropic
+
+New AI providers are added regularly.
+
+When configuring AI providers, you can choose from two possible options:
+
+* **Use your own API keys** – Crowdin recommends this option if data security is a concern and for enhanced privacy and ownership. This option requires an external registration for getting API keys/credentials from AI providers.
+* **Use Managed by Crowdin service** – simplified AI integration without the need to manage your own API keys. Allows you to leverage Crowdin's default settings and infrastructure to access AI capabilities in a convenient way. Ideal for straightforward, quick tasks. To start using AI providers managed by Crowdin, you just need to top up your balance.
+
+To configure an AI provider, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Providers** tab, click toward the needed provider and select **Edit**. Alternatively, just double-click on the needed provider.
+
+ 3. Select **Enabled**.
+
+ 4. *(Optional)* Select the **\{Provider} managed by Crowdin** option if you'd like to use the providers managed by Crowdin. In this case, you'll need to [top up your account balance](#topping-up-account-balance).
+
+ 5. Specify your own AI provider API key. Follow AI provider instructions on how to generate an API key.
+
+ 6. AI providers like Google Gemini and Microsoft Azure Open AI have slightly different configuration options compared to others:
+ * Project ID (Specific to Google Gemini)
+ * Region (Specific to Google Gemini)
+ * Service Account Key (Specific to Google Gemini)
+ * Resource name (Specific to Microsoft Azure Open AI)
+ * Deployment name (Specific to Microsoft Azure Open AI)
+ * API Version (Specific to Microsoft Azure Open AI)
+
+ 7. Click the **Advanced settings** to access the model-related settings:
+ * In the **Models** section, for each prompt type (i.e., Pre-translate and Ai in editor), select the preferred models you'd like to use from the drop-down menu or leave these fields as is to use all available models.
+
+ 8. Click **Update**.
+
+
+
+
+### Disabling AI Providers
+
+If needed, you can disable any of the previously enabled providers at any time.
+
+To disable the AI provider, follow these steps:
+
+
+ 1. Open your profile and select **AI** on the left sidebar.
+
+ 2. In the **Providers** tab, click toward the needed provider and select **Disable**. Alternatively, double-click on the needed provider and clear **Enabled** in the provider's settings.
+
+
+### Topping Up Account Balance
+
+MT engines and AI models managed by Crowdin are separately paid services. To use them, you first need to top up your Crowdin account balance.
+
+You can do it in your **Account settings > Billing > MT engines and AI models managed by Crowdin** or by clicking **Manage** when configuring your AI provider.
+
+In the **Top Up Balance** field, specify the amount for which you want to top up your Crowdin account and click **Top Up**.
+
+Additionally, to ensure uninterrupted operation of the Managed by Crowdin service, you can set the preferred amount in the **Balance warning threshold** field so that when your Crowdin account balance reaches this point, you'll automatically receive a notification.
+
+
+
+### AI Settings for the Account
+
+To configure default settings for AI prompts across your Crowdin account, open your profile and go to **AI > Settings**.
+
+**Prompt to be used in editor** – select the default AI prompt that will be used in the Editor for all projects in your Crowdin account. If needed, this default setting can be overridden for each project individually in the project's **Settings > AI > Settings**.
+
+
+
+## Pre-translation via AI
+
+Pre-translation via AI enhances localization efficiency to a remarkable degree, reaching new levels of speed and accuracy. Providing high-quality, context-aware translations in just a few clicks, it significantly reduces manual effort and accelerates project completion, which is especially beneficial for large localization projects.
+
+Once you configured your AI providers and AI prompts, you can use them for pre-translation of your Crowdin project content similarly as MT or TM.
+
+To apply pre-translation via AI, follow these steps:
+
+
+ 1. Open your project and go to the **Dashboard** tab.
+
+ 2. Click **Pre-translation** and select **via AI**.
+ 
+
+ 3. Select the preferred AI prompt.
+
+ 4. Select the target languages and files you want to pre-translate.
+
+ 5. *(Optional)* You can specify labels in the **Filter by labels** and **Exclude by labels** fields to filter strings, including or excluding them during pre-translation.
+
+ 6. Click **Pre-translation via AI**.
+
+
+## Using AI in the Editor
+
+After configuring a prompt with the **AI in editor** type, Crowdin AI can be used in the Editor as an AI Assistant for translators and proofreaders. This AI Assistant can be communicated with in a chat format, allowing you to send prompts and receive replies.
+
+The AI Assistant is context-aware, meaning it knows the string the translator is working on, the related glossaries, TM matches, the maximum acceptable length of the translation, the related screenshots, etc. This contextual awareness enables the AI Assistant to provide more accurate and relevant assistance.
+
+Here are some tasks the AI Assistant can help with:
+
+* Correcting TM suggestions: If you get a 60% match, the AI Assistant can improve the remaining 40%, ensuring consistency with your terminology and previous translations.
+* Serving as an advanced dictionary: The AI Assistant can provide term definitions, translation variants, synonyms, and more.
+* Suggesting translations: Similar to other MT tools, the AI Assistant can suggest translations which you can further refine based on your specific needs or save as is.
+
+In addition, the AI Assistant can help in translating knowledge base articles by providing short summaries, helping you grasp the content quickly before translating.
+
+When working in the Editor, you can start using the AI Assistant by clicking the AI Assistant tab in the right sidebar.
+
+
+
+For faster and more efficient interaction with the AI Assistant, you can use prompt shortcuts. By default, there are three prompt shortcuts available:
+
+* Rephrase
+* Shorten
+* Translate all
+
+To add your own prompt shortcuts, follow these steps:
+
+
+ 1. Click in the upper-right corner to open the AI settings.
+
+ 2. Click **Add shortcut**.
+
+ 3. Specify a shortcut name and a prompt it will be using.
+
+ 4. Click **Save**.
+
+
+Additionally, in the **Editor Settings > AI** tab, you can create a custom prompt to provide the AI Assistant with a specific set of instructions that are sent each time you make a request. Note that the custom prompt is project-specific.
+
+
+
+When sending prompts to the AI Assistant, the instruction priorities are considered in the following order:
+
+1. Instructions specified in the [**AI in editor** prompt settings](#configuring-ai-prompts).
+2. Instructions specified in the custom prompt settings.
+3. Instructions specified in the prompt shortcut or manually entered in the AI Assistant chat.
+
+## Configuring AI Prompts in the Project Settings
+
+AI providers, models, and prompts can't be assigned across different Crowdin accounts. However, AI prompts for use in a project can be configured by project managers in the project's **Settings > AI**. The AI prompts configured in the project settings will also be added to the list of AI prompts of the project owner's Crowdin account.
+
+To configure an AI prompt for a project, go to project's **Settings > AI** and follow the [configuration instructions](#configuring-ai-prompts).
+
+
+
+Besides configuring prompts in the project settings, you can also change the [default AI settings](#ai-settings-for-the-account) applied from the project owner's account.
+
+## Managing AI Providers and AI Prompts via API
+
+Besides UI, AI Providers and AI Prompts can also be managed using the API methods from the AI sections:
+
+* [AI section (File-based)](https://developer.crowdin.com/api/v2/#tag/AI)
+* [AI section (String-based)](https://developer.crowdin.com/api/v2/string-based/#tag/AI)
+
+## See Also
+
+