# Subtitles

#### Step-by-Step Guide

**Step 1: Navigate to the Subtitles Settings**

* Go to Personalize Project and select settings.
* Now click on “**Voice and Subtitles**” to personalize.
* On the same page, you can see the marked voice variables in the actual script.

<figure><img src="/files/9qv9nPCwQKyhtWOvvpHi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xEKujwhCnkNynbKT6U0J" alt=""><figcaption></figcaption></figure>

**Step 2: Enable Subtitles for the Video**

* In the Subtitles section, go to “**Edit Subtitles**” and toggle “**Enable Subtitles**” so that the system starts generating captions.
* If your base video includes spoken content, the system will analyze the audio and align subtitle lines accordingly.

<figure><img src="/files/WvyFFnmqp107p1Rq7JSo" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RAiOU5Sz4FpltIl8LZGA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/piuVWJKw91bu5a6yTDYE" alt=""><figcaption></figcaption></figure>

**Step 3: Subtitles Options**

Once you have enabled the subtitles, two options will be available for the subtitles as below:

1. **Auto-Generated Subtitles**

* Gan.AI automatically transcribes your video and generates accurate subtitles aligned with the audio script.

**How it works:**

* The platform uses AI transcription to detect spoken words and place subtitles in sync with the video.
* Once generated, you can edit text and style the subtitles from within the editor.
* This method is ideal for most videos since it saves time and ensures alignment with the spoken script.

<figure><img src="/files/vNzX18CJeDr3DHEwBz8D" alt=""><figcaption></figcaption></figure>

2. **Upload Custom Subtitles**

* If you already have a subtitle file created elsewhere, Gan.AI lets you upload your own subtitle file instead of using auto-generated ones.

**To upload:**

1. Go to the **Subtitles** tab inside your personalized project.
2. Click “**Upload Subtitles**” (or Upload Custom File).
3. Select your .srt file from your system.
4. Once uploaded, preview the video to ensure proper timing and alignment.
5. You can still **edit or personalize** these subtitles inside the editor (add variables, adjust colours/size, etc.).

<figure><img src="/files/ClYeYla1d2lmTCz86mmB" alt=""><figcaption></figcaption></figure>

**Step 4: Personalize Subtitles Using Variables**

* To make subtitles personalized for each recipient: insert variables into the subtitle text (e.g., <mark style="color:$success;">@FirstName, @Company</mark>).
* Select the text you want to change and select from the available variables as per the requirements.
* Example: change “Welcome to the demo” → “Welcome, @FirstName from @Company!”
* Ensure that your data source (CSV or integration) contains matching columns for each variable you use. Ensure that your data source (CSV or integration) contains matching columns for each variable you use.

<figure><img src="/files/TJTT7vE870y79oYPWzr4" alt=""><figcaption></figcaption></figure>

**Step 5: Customize Subtitle Design**

1. Under Edit Subtitle Design, choose:

* Font size, color, and transparency
* Text and background colour
* Subtitle box transparency
* On-screen position (bottom, middle, or custom)

2. Preview changes live before saving.

<figure><img src="/files/PaljtEs8MM3ddN3gAorp" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/iiYQL2CuFBsr6WUneMI7" alt=""><figcaption></figcaption></figure>

**Step 6: Preview and Publish**

* Click Preview to test both the subtitle accuracy and personalization by playing the video on the same page.
* For personalized projects, check at least two sample entries with variable substitution.
* When ready, click **Save & Close** in the top right corner.

<figure><img src="/files/L8CjDKmgkcw1TpTGrJdv" alt=""><figcaption></figcaption></figure>

#### Best Practices

* Always test auto-generated subtitles for accuracy, especially in videos with background noise or multiple speakers.
* Use short, readable lines (no more than two per frame).
* Keep variable placeholders consistent with your data sheet or CRM field names.
* Choose high-contrast text colours for accessibility.
* Preview on both desktop and mobile to ensure readability.

With Gan.AI’s subtitle tools, you can make your videos more accessible, more engaging, and more personalized—all within a few clicks. By combining auto-generated captions, custom uploads, and variable-driven personalization, every viewer receives a tailored experience that feels clear, relevant, and professional. Clean design, accurate timing, and thoughtful placement help ensure your subtitles enhance the message without distraction.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.gan.ai/getting-started-onboarding/personalized-project/setting-up-your-personalized-project/subtitles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
