> For the complete documentation index, see [llms.txt](https://insync.gitbook.io/interactive-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://insync.gitbook.io/interactive-studio/motion-flow/limitations-and-problems.md).

# Limitations & Problems

This page covers current limitations and common issues when using **Motion Flow**, along with tips to ensure smooth scroll playback.

Most issues are related to video size and performance, especially on slower devices or networks.

***

### Performance Limitations

#### ⚠️ Large or Long Videos

> Motion Flow converts videos into optimized image sequences for scroll playback.
>
> While the files are heavily compressed and optimized, very large or long videos can still cause:
>
> * longer loading times
>
> * less smooth scrolling
>
> * higher memory usage on slower devices
>
> This is especially noticeable on:
>
> * mobile devices
> * slower internet connections
> * older laptops

{% hint style="info" %}
**Recommendation:** Keep videos as short and lightweight as possible while maintaining visual quality.
{% endhint %}

***

### Upload Limits

#### Maximum File Size: 30 MB

> You can upload videos up to **30 MB**.
>
> If your file is larger:
>
> * the upload may fail
> * or processing may not start
>
> 👉 Always check file size before uploading.

#### Supported Formats Only

> Only the following video formats are supported:
>
> * **MP4**
> * **MOV**
>
> Other formats will not upload or process correctly.

***

### Upload Issues

#### Upload Fails or Gets Stuck

> If your upload does not complete:
>
> 1. Check that the file is under **30 MB**
>
> 2. Make sure the format is **MP4 or MOV**
>
> 3. Stay on the upload tab while processing is running
>
> If everything is correct and the upload still fails:
>
> 👉 Wait about **15 minutes** and try again.

This can happen during periods of high server load when many users are uploading videos at the same time.

***

### Best Practices for Smooth Playback

To get the best scroll performance:

* avoid unnecessary long videos
* keep motion simple and readable
* use section heights of **300vh–600vh** for smoother pacing
* test on the live site before publishing final layouts

Optimizing the source video before upload can also help.

***

### If Something Is Not Working

If you continue to experience issues:

* test with a smaller video file
* try using a template sequence to compare behavior
* republish your site and test on live

If problems persist, please contact <support@interactive-studio.io> and include:

* your site link
* video file size and format
* a short description of what’s happening