Skip to main content

Deploy Wagtail sites to Netlify

Project description


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.

Project details

Download files

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

Source Distribution

wagtailnetlify-0.7.tar.gz (8.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page