> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Export a transcript: subtitles, documents and data

> Download a transcript as SRT or WebVTT subtitles, a Word document, plain text, PDF, a web page or JSON, with or without speaker names, or copy it with timestamps.

You can download a finished transcript in seven formats: two subtitle formats, Word, plain text, PDF, a web page and JSON. The exports use the transcript as it is now, with your edits and speaker names. This page shows how to export, what each format contains, and how to copy the text instead.

## Export from the transcript

**1. Open the transcript**

In **Speech to text**, click a **Completed** transcript.

**2. Choose speaker names**

Open **Download** in the header. Tick or clear **Include speaker names**. It's on by default, applies to the first four formats, and is remembered in this browser.

**3. Pick a format**

Click the format. Long transcripts take a moment: "Gathering the transcript: page 2 of 5". The file is named after the transcript's title.

![The Download menu of a transcript: SRT subtitles, WebVTT subtitles, Word document and Plain text, Include speaker names ticked, then PDF, Web page and JSON, each with its extension](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/export-menu-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=14a9135eba72a3ba8f592847ad482786)

You can also export from Cmd+K (Ctrl+K on Windows) while the transcript is open: "Export as SRT", "Export as VTT", "Export as DOCX", "Export as text".

## Formats

| Format | File | What it contains | Follows **Include speaker names** |
| - | - | - | - |
| **SRT subtitles** | .srt | Numbered cues, `00:00:01,000 --> 00:00:04,500`, then the text | Yes: `Speaker 1: text` |
| **WebVTT subtitles** | .vtt | A `WEBVTT` header, then cues with `00:00:01.000 --> 00:00:04.500` | Yes, as a voice tag: `<v Speaker 1>text` |
| **Word document** | .docx | The title, then each segment's time (and speaker) above its text. Arabic paragraphs run right to left | Yes |
| **Plain text** | .txt | One line per segment: `[00:00:01] Speaker 1: text` | Yes |
| **PDF** | .pdf | For each segment: its number, speaker, start, end and text, with Arabic set right to left | No, always includes the speaker |
| **Web page** | .html | The same fields as the PDF, as a simple web page | No, always includes the speaker |
| **JSON** | .json | A list of segments, each with `id`, `text`, `startedAt`, `endAt`, `createdAt` and `transcriptSpeaker` (`id`, `speaker`) | No, always includes the speaker |

Subtitle and text times are hours, minutes and seconds (`00:01:24`). PDF, web page and JSON times are minutes and seconds (`1:24`).

Empty segments are left out of the subtitle, Word and text files.

> [!NOTE]
>
> PDF, web page and JSON use the speaker names saved on the transcript. A speaker you haven't renamed appears as `speaker_0`, `speaker_1` and so on, and a segment without one as "Unknown". Rename speakers first if those files go to someone else. See [Speakers](https://docs.tryhamsa.com/media/speech-to-text/speakers.md).

A JSON export looks like this:

```json theme={null}
[
  {
    "id": "8f1c2b7a-4d3e-4a51-9b6f-0c2d1e3f4a5b",
    "text": "مرحبا بكم في الحلقة الأولى",
    "startedAt": "0:01",
    "endAt": "0:04",
    "createdAt": "2026-10-30T09:12:44.000Z",
    "transcriptSpeaker": { "id": "2a9e0c14-6b7d-4f02-8e3a-5c1d9b0f7e66", "speaker": "speaker_0" }
  }
]
```

## Export several transcripts

In the **Speech to text** list, select the rows of completed transcripts and choose download. You pick one format (SRT, WebVTT, Word or plain text) for all of them. See [Lists and uploads](https://docs.tryhamsa.com/media/workspace/lists-and-uploads.md).

![Three transcripts selected in the list, and the Download menu of the bar at the bottom: SRT subtitles, WebVTT subtitles, Plain text and Word document](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/bulk-download-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=255c29dee1551fe4f02e0f8932231c91)

## Copy instead of downloading

* **Copy** in the header: **Copy transcript with timestamps** puts every segment on the clipboard as `[01:24] Speaker 1: text`, one per line.
* A segment's **More actions** menu: **Copy with timestamp** for that one segment.
* Select segments with Shift-click and choose **Copy selection**.

See [Copy, link and select](https://docs.tryhamsa.com/media/speech-to-text/transcript-editor.md#copy-link-and-select).

![The Copy menu in the transcript header: Copy transcript with timestamps, Copy link at 00:00, Send to text to speech and Use in a voice over](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/copy-menu-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=9923e598ef3112a0a6ef670202a0a73e)

## Export from the API

The server formats (and SRT, plain text, Word and CSV in the server's own layout) can be downloaded with an API key:

```bash theme={null}
curl "https://api.tryhamsa.com/v2/transcript-jobs/JOB_ID/transcripts/export?projectId=YOUR_PROJECT_ID&type=JSON" \
  -H "Authorization: Token YOUR_API_KEY" \
  -o transcript.json
```

`type` is one of `PDF`, `DOCX`, `TEXT`, `JSON`, `CSV`, `SRT` or `HTML`. These files always include the speaker and use the server layout described for PDF above, not the app's SRT, text and Word layouts. WebVTT is only available from the app.

## Related

> [card] [Transcript editor](https://docs.tryhamsa.com/media/speech-to-text/transcript-editor.md)
>
> Correct the text before you export.

> [card] [Speakers](https://docs.tryhamsa.com/media/speech-to-text/speakers.md)
>
> Name speakers so exports read well.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.