Grow has a powerful and simple extension system that enables you to extend the functionality of Grow with extensions.
Grow supports an
extensions.txt file as part of the pod. When the file is
grow install command will handle the installation of the
# extensions.txt git+git://github.com/grow/grow-ext-contentful
extensions.txt follows the same format as a normal pip
style. This means you can install pip packages or directly from
See the documentation for each extension for instructions on how to properly
configure the extension and what settings to add to the
When possible, extensions should be created as separate repositories and use the
extensions.txt file to reference the extension. This helps the extensions be reusable across projects.
In some cases it makes more sense to write the extension inside the same repository as it is very specific to the site. The same principles apply just put the extension files into a subdirectory inside the
Extensions are standard Python modules, so your site's
extensions folder must be set up appropriately, with
├── /extensions # All your extensions | ├── /__init__.py # Empty file, required by Python | └── /extension_name # Subfolder for custom extension | ├── /__init__.py # Empty file, required by Python | ├── /extension_name.py # Extension code