Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

* Support triggering builds on Netlify automatically

* Update version

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


PyPI version

Deploy your Wagtail site on Netlify. Features include:

  • automatic deployment when pages are published
  • a new netlify management command
  • conversion of Wagtail redirects to Netlify's format

Screencast demo


  1. Install and configure Wagtail Bakery, if you haven't already.
  2. Install Netlify CLI v2.x, if you haven't already.
  3. Install Wagtail-Netlify via pip (with pip install wagtailnetlify).


  1. Add wagtailnetlify to your INSTALLED_APPS.
  2. Run the migrations: ./ migrate wagtailnetlify.
  3. Add NETLIFY_PATH or NETLIFY_BUILD_HOOK to your settings.

Check the Settings section below for more customisation options.


If NETLIFY_AUTO_DEPLOY is set to True, Wagtail will automatically deploy your site every time a page is published.


To deploy changes manually, use ./ netlify.

To generate redirects without deploying, use the -n or --no-deploy flag: ./ netlify --no-deploy.

To trigger a build on Netlify's servers, configure settings.NETLIFY_BUILD_HOOK and use the -t or --trigger-build flag: ./ netlify --trigger-build.



The path to the Netlify CLI. Hint: type which netlify to check the location.


Default: None

If set, deploy to that specific Netlify site.

If not set, the Netlify CLI might prompt you to select one.


Default: None

If set, the Netlify CLI will not prompt you to click the authentication link in the console. It can be useful when deployed to a remote server where you don't see the console output.

Connect to your Netlify account to generate a token and then set the settings. Warning: You should never check credentials in your version control system. Use environment variables or local settings file instead.


Default: False

Whether to automatically deploy your site to Netlify every time you publish a page. This make take between a few seconds and a few minutes, depending on the size of your site, and the number of pages which are affected by your change. If you have configured settings.NETLIFY_BUILD_HOOK, publishing a page will trigger a build on Netlify's servers.


Default: wagtailnetlify.models.deploy

The function to be called when a deploy is triggered (excluding when triggered manually with the ./ netlify command). It can be useful if you want to use your own task runner (like Celery) instead of the built-in threading model.

The function needs to be a valid Django signal receiver.


Default: None

The URL of a Netlify build hook. If provided, ./ netlify --trigger-build will call this hook, triggering a build on Netlify's servers. This may be useful if you have a headless front-end on Netlify which handles its own static site generation, e.g. Nuxt, Next or Gatsby. See for more details.

Optional admin view and endpoints

Netlify can send a webhook after a successful deployment. This app provides an endpoint for that webhook and an admin view of completed deployments. To enable this view:

  1. Add wagtail.contrib.modeladmin to your INSTALLED_APPS
  2. Update your project's
# in your imports
from wagtailnetlify import urls as netlify_urls

# in urlpatterns, before including wagtail_urls
url(r"^netlify/", include(netlify_urls)),
  1. In Netlify's admin interface for your app, add http://yourdomain/netlify/success as a URL to notify for the outgoing webhook on Deploy succeeded events (in Settings / Build & deploy / Deploy notifications).

The view will be available under Settings / Deployments in your site's admin.

Including the wagtailnetlify URLs will also enable a view at /netlify/redirects, which outputs any Wagtail redirects in Netlify's plain text format. This may be useful if you are using Netlify to host a headless front-end for your Wagtail site.



  1. Ensure you have the latest versions of pip, setuptools and twine installed in your virtual environment.
  2. Ensure your master branch is up to date.
  3. Create a new branch (e.g. release/v1.1.3) for the release of the new version.
  4. Update the version number in wagtailnetlify/ following Semantic Versioning.
  5. Update
  6. (Optional) If you need to verify anything, use make publish-test to upload to and enter your PyPi test credentials as needed.
  7. On GitHub, create a pull request and squash merge it.
  8. Checkout and pull the master branch locally.
  9. Use make publish and enter your PyPi credentials as needed.
  10. On GitHub, create a release and a tag for the new version.