How to fix the “Module too large” warning

Learn how to reduce the size of a CMS collection, page, component, or module so it can publish successfully.

If Framer shows a “Module too large” warning, it means a CMS collection, web page, component, or site module has exceeded the size limit for publishing.

Your content is still safe, and you can continue editing it. However, Framer will stop updating that item during publishing until its size is reduced. These limits help keep your published site fast and reliable.

Reduce the size of web pages and components

Try the following steps to make large pages and components smaller:

  1. Remove unused images, CMS items, and layers.

  2. Split large sections into reusable components.

  3. Break large pages into multiple smaller pages.

  4. Combine repeated layouts into a single reusable component.

  5. Avoid embedding large images directly inside components or variants.

  6. Replace imported SVGs with image fills where possible.

  7. Optimize large image and video files, or host videos with YouTube or Vimeo instead.

Reduce the size of CMS collections

Large CMS collections can also trigger this warning. To reduce their size:

  1. Remove unused CMS items and layers.

  2. Split one large collection into several smaller collections.

  3. Optimize uploaded images and videos, or host videos with YouTube or Vimeo instead.

Reduce the size of a site module

If the warning appears for a site module, review the module structure and remove anything unnecessary.

  1. Remove unused modules or exports.

  2. Split large modules into smaller, purpose-specific modules.

  3. Include only the code required by the pages that use the module.

FAQ

Lesson FAQ

  • Why am I seeing the “Module too large” warning?

    This warning appears when a page, CMS collection, component, or module exceeds Framer’s size limits for publishing. These limits help ensure your site loads quickly and performs reliably.

  • Will I lose my content if I see this warning?

    No. Your content remains safe and editable. However, Framer will not publish updates to the affected item until its size is reduced.

  • How do I know what is causing the size issue?

    Common causes include large images or videos, too many CMS items, or overly complex pages and components. Start by removing unused assets and splitting large structures into smaller parts.

Updated