Discord video won't play or embed? Why it shows as a file and how to fix it

By the FixMP4 engineering team · · 8 min read

Discord can play videos right in the chat, but only some videos. If a clip you upload appears as a plain file with a download button, shows a black player, or stops after a few seconds, either Discord's player cannot handle the format or the file itself is incomplete. The fix depends on which, so the first job is to tell them apart.

Download it and test it

Download the attachment from Discord (or use your original file) and open it in VLC.

  • Plays fully in VLC: the file is fine. Discord does not support the format for inline playback. Convert it, as described below.
  • Stops early or fails in VLC too: the file is damaged or incomplete. Repair it first, then share the repaired version.

What Discord plays inline

Discord's built-in player is based on what common browsers and its desktop and mobile apps can decode. In practice, the most reliable combination is:

  • MP4 container (WebM also works well),
  • H.264 video,
  • AAC audio,
  • a standard frame rate and resolution.

Files outside this pattern often become a plain attachment. The usual suspects are:

  • HEVC (H.265) from iPhones set to High Efficiency, newer Android phones, drones and action cameras;
  • MKV files from OBS and other recorders, which Discord generally does not embed;
  • MOV files with codecs other than H.264;
  • AVI, WMV and other older formats;
  • files with unusual audio, such as PCM or multi-channel tracks.

Convert to a format that embeds

A quick re-encode makes almost any healthy video embed. With FFmpeg:

`` ffmpeg -i input.mov -c:v libx264 -crf 23 -preset medium -pix_fmt yuv420p -c:a aac -b:a 128k -movflags +faststart discord.mp4 ``

Raising the -crf value (for example to 28) makes the file smaller at some cost in quality, which helps with upload limits. The -movflags +faststart option puts the index at the start so the player can begin quickly.

Without a command line, HandBrake does the same: pick a 1080p or 720p preset, keep the format at MP4 with H.264 video, and export. If the original is an MKV from a recorder, you can often convert to MP4 without re-encoding (a remux), but if the video inside is HEVC it still will not embed reliably, so a full H.264 re-encode is safer.

For iPhone videos, the guide to converting MOV to MP4 covers the options, including setting the camera to Most Compatible so new recordings are H.264 from the start.

Upload size and compression

Discord limits upload size, and the limit depends on your account and the server you post in. Large uploads fail or are refused. To fit:

  • trim the clip to the part that matters;
  • lower the resolution to 720p for chat sharing;
  • increase compression (a higher CRF in FFmpeg, or a lower quality setting in HandBrake);
  • or upload the full video to a cloud service and share the link.

Check Discord's help centre for the current size limits, since they change.

When the file is actually damaged

If the downloaded file fails in VLC as well, it is incomplete. Common histories include a game clip saved by a recorder that crashed, a phone video recorded while the battery died, and an export that stopped early. In MP4 and MOV files, the player needs an index of all frames, written at the end of recording; without it, nothing plays.

Re-uploading will not help. Fix the file first:

  1. Record a short clip with the same device or app and settings to use as a reference.
  2. Open the FixMP4 repair tool, add the damaged file and the reference.
  3. FixMP4 rebuilds the index inside your browser; the clip is not uploaded for the repair.
  4. Confirm the result in the free preview, save it, and convert it for Discord if needed.

For game clips, the guides to Xbox Game Bar, OBS recordings and ShareX recordings explain the recorder-specific details.

Videos that play but look wrong

Some issues are not about embedding:

  • Sideways video: the rotation flag is ignored by some players. See fixing a sideways video.
  • Audio drifts out of sync in longer clips, usually because of variable frame rate. Re-encoding with a constant frame rate fixes it; fixing audio out of sync has the details.
  • Black video with sound: often an unsupported codec on the viewer's device, solved by H.264.

Similar embedding and playback problems show up in other messaging apps; see WhatsApp videos not playing and Telegram videos not playing.

Summary

If a Discord video will not play inline, test it in VLC. A file that plays there needs converting to H.264 MP4 with AAC audio, within your upload limit. A file that fails everywhere is damaged and should be repaired in FixMP4 before you share it again.

Videos saved from Snapchat are covered in Snapchat Memories video won't play.

Frequently asked questions

Why does my video show as a file download in Discord instead of playing?

Discord previews videos only when the format and codec are ones it can play in its built-in player. Files with HEVC video, uncommon containers or unusual audio often appear as a plain attachment. Converting the video to an H.264 MP4 with AAC audio usually makes it play inline.

Why do iPhone videos not play on Discord?

iPhones record in HEVC by default when the camera format is set to High Efficiency. Whether HEVC plays in Discord depends on the device and app version, so many viewers get a download link or a black player. Switching the iPhone camera to Most Compatible, or converting the clip, avoids this.

My Discord video plays for a few seconds and then stops. Is it corrupted?

Possibly. Download the attachment and play it in VLC. If it stops at the same point there too, the uploaded file itself is incomplete. If it plays fully in VLC, the problem is Discord's player or your connection.

Is there a file size limit for Discord videos?

Yes. Discord limits upload size, and the limit depends on your account and the server's boost level. Check Discord's help centre for the current figures. Compressing the video or sharing a link from a cloud service are common ways around it.

Have a broken recording right now?

Diagnose it and hear or watch a free repaired preview. Nothing is uploaded.

Open the repair tool
  • Discord
  • video embed
  • HEVC
  • MOV
  • MP4