# 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


---

# 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://insync.gitbook.io/interactive-studio/motion-flow/limitations-and-problems.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.