Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Integration of lazysizes, a lightweight lazy loader, into Plone.

Project description

Life, the Universe, and Everything

This package integrates lazysizes, a lightweight lazy loader, into Plone.

lazysizes is a fast, SEO-friendly and self-initializing lazyloader for images (including responsive images picture/srcset), iframes, scripts/widgets and much more. It also prioritizes resources by differentiating between crucial in view and near view elements to make perceived performance even faster.

By using this package you can expect reductions of up to 80% in load time, 75% in page size and 50% in number of requests.

Mostly Harmless

These are some sites using collective.lazysizes:

As long as we have tested, lazysizes seems not to interfere with image indexing made by crawlers like Googlebot.

Got an idea? Found a bug? Let us know by opening a support ticket.

Don’t Panic


To enable this package in a buildout-based installation:

  1. Edit your buildout.cfg and add add the following to it:

    eggs =

After updating the configuration you need to run ‘’bin/buildout’‘, which will take care of updating your system.

Go to the ‘Site Setup’ page in a Plone site and click on the ‘Add-ons’ link.

Check the box next to collective.lazysizes and click the ‘Activate’ button.

How does it work

This package adds a transformer to the transform chain to integrate lazysizes into Plone.

The transformer looks for all the <img>, <iframe> and <blockquote> tags inside the content and does the following:

  • appends a lazyload class
  • if the tag is an <img>, transforms the src attribute into a data-src and uses a gray square in its place to maintain valid HTML code (this placeholder is loaded using the data URI scheme to avoid a new request to the server)
  • if the tag is an <iframe>, transforms the src attribute into a data-src
  • if the tag is a <blockquote> containing a tweet, it adds a data-twitter attribute and removes the <script> tag associated with the Twitter widget to avoid a useless request

These transforms are applied to anonymous users only.

Share and Enjoy

collective.lazysizes would not have been possible without the contribution of the following people:

You can find an updated list of package contributors on GitHub.

Development sponsored by Simples Consultoria.


4.0.1 (2017-11-20)

  • Upgrade lazysizes to v4.0.1. Twitter plugin is now CommonJS compatible. [hvelarde]
  • Require >=1.5. Refs #42 [erral]

3.1 (2017-10-02)

  • Add German translations. [thet]
  • Add explicit i18n message ids instead of implicit based on the translation string. [thet]
  • Fix Plone 5 compatibility. [thet]
  • Extend the uninstall profile with more de-registrations. [thet]
  • Fix the blacklist XPath selector to also match elements with the class directly set on it. [thet]
  • Add configlet option to enable lazy loading for authenticated users. [hvelarde]
  • Avoid possible overriding of css_class_blacklist while upgrading. [hvelarde]
  • Avoid possible ConfigurationConflictError on upgrade step registration. [hvelarde]

3.0.0 (2017-03-09)

  • Update lazySizes to v3.0.0. [hvelarde]
  • Remove respimg polyfill plugin. [hvelarde]
  • Fix UnicodeEncodeError on logger. [hvelarde]

2.0.5rc1 (2016-10-28)

  • Clean up configlet; the image_candidates field was removed as the intended functionality will be included in Plone’s core in the near future (see PLIP 1483). [hvelarde]
  • Remove dependency on five.grok. [hvelarde]
  • Update lazysizes to v2.0.5. [hvelarde]
  • Pin version of Products.ResourceRegistries >=2.2.12 to fix upgrade step. [rodfersou, hvelarde]

2.0.0b1 (2016-08-11)

  • lazysizes was upgraded to version 2.0.0 and we are using now the AMD module (closes #20). [rodfersou]
  • Do not raise an exception in case Twitter’s embed code was somehow modified (closes #17). [hvelarde]

1.5.0b1 (2016-05-25)

  • Embedded tweets are now also lazy loaded (closes #15). [aFarkas, rodfersou, hvelarde]
  • Package is now compatible with Plone 5.0 and Plone 5.1. [hvelarde]

1.5.0a1 (2016-04-07)

  • Use data URI scheme for image placeholder to save one additional request (closes #8). [hvelarde]
  • Brazilian Portuguese and Spanish translations were added. [hvelarde]
  • Deal better with <img> tags with no src attribute; log an error message with the request URL (closes #11). [hvelarde]
  • Package is now compatible with Plone 5. [hvelarde]
  • Remove dependency on Products.CMFQuickInstallerTool. [hvelarde]
  • Update lazysizes and respimg polyfill extension to v1.5.0. [hvelarde]

1.4.0a1 (2016-02-23)

  • Add option to list class identifiers that will not be processed for lazy loading. <img> and <iframe> elements with that class directly applied to them, or to a parent element, will be skiped (closes #5). [rodfersou, hvelarde]
  • Update lazysizes and respimg polyfill extension to v1.4.0. [hvelarde]
  • Use a blank image instead of a spinner as placeholder. [hvelarde]
  • Logging now uses debug level instead of info. [hvelarde]

1.0a1 (2016-01-05)

  • Initial release.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
collective.lazysizes-4.0.1.tar.gz (38.8 kB) Copy SHA256 hash SHA256 Source None Nov 20, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page