From ae66f01566054e7d40594e41c2d58433960f40d0 Mon Sep 17 00:00:00 2001
From: Vanilagy <1696106+Vanilagy@users.noreply.github.com>
Date: Fri, 14 Aug 2026 11:54:43 +0200
Subject: [PATCH] Clarify Conversion API codec field default

---
 docs/guide/converting-media-files.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guide/converting-media-files.md b/docs/guide/converting-media-files.md
index 38440d8..ba0ac96 100644
--- a/docs/guide/converting-media-files.md
+++ b/docs/guide/converting-media-files.md
@@ -231,7 +231,7 @@ The `frameRate` property can be used to set the frame rate of the output video i
 
 ### Transcoding video
 
-Use the `codec` property to control the codec of the output track. This should be set to a [codec](./supported-formats-and-codecs#video-codecs) supported by the output file, or else the track will be [discarded](#discarded-tracks).
+Use the `codec` property to control the codec of the output track. This should be set to a [codec](./supported-formats-and-codecs#video-codecs) supported by the output file, or else the track will be [discarded](#discarded-tracks). When not set and transcoding needs to happen, Mediabunny will automatically pick a codec that the environment can encode and the output format can contain.
 
 Use the `quality` property to control the quality of the output video. For example, you can use this field to compress the video track. See [Encoding quality](./media-sources#encoding-quality) for more. If this property is set, transcoding will always happen. If this property is not set but transcoding is still required, `new Quality('high')` will be used as the value.
 
@@ -323,7 +323,7 @@ The `sampleRate` property controls the sample rate in Hz (e.g., 44100, 48000). I
 
 ### Transcoding audio
 
-Use the `codec` property to control the codec of the output track. This should be set to a [codec](./supported-formats-and-codecs#audio-codecs) supported by the output file, or else the track will be [discarded](#discarded-tracks).
+Use the `codec` property to control the codec of the output track. This should be set to a [codec](./supported-formats-and-codecs#audio-codecs) supported by the output file, or else the track will be [discarded](#discarded-tracks). When not set and transcoding needs to happen, Mediabunny will automatically pick a codec that the environment can encode and the output format can contain.
 
 Use the `quality` property to control the quality of the output audio. For example, you can use this field to compress the audio track. See [Encoding quality](./media-sources#encoding-quality) for more. If this property is set, transcoding will always happen. If this property is not set but transcoding is still required, `new Quality('high')` will be used as the value.