|
| 1 | +--- |
| 2 | +title: Wagtail |
| 3 | +homepage: https://wagtail.org/ |
| 4 | +repo: wagtail/wagtail |
| 5 | +twitter: wagtailcms |
| 6 | +opensource: "Yes" |
| 7 | +typeofcms: "API Driven" |
| 8 | +supportedgenerators: |
| 9 | + - All |
| 10 | +description: Wagtail is the leading open-source Python CMS. Based on Django, it supports both traditional and headless sites via REST and GraphQL APIs. |
| 11 | +images: |
| 12 | + - path: /img/cms/wagtail-page-editor.png |
| 13 | +--- |
| 14 | + |
| 15 | +Wagtail is an open-source CMS built on the Django web framework, focused on flexibility and user experience. |
| 16 | + |
| 17 | +Its major features are: |
| 18 | + |
| 19 | +- **StreamField**. An intuitive block-based page editor, so authors control how content is displayed and how data is organised. |
| 20 | +- **Page tree**. A tree structure for the site’s pages, that makes content easy to find and organise. |
| 21 | +- **Customizable page types**. Using Django models to easily create and extend a custom architecture. |
| 22 | +- **Snippets**. Reusable components that editors can use over and over again. |
| 23 | +- **Advanced image management**. Image library organisation, custom cropping tools, and advanced image optimisations. |
| 24 | + |
| 25 | +Built upon Django, Wagtail projects can leverage an ecosystem of thousands of [Django packages](https://djangopackages.org/), as well as Wagtail-specific plugins. |
| 26 | + |
| 27 | +## Headless features |
| 28 | + |
| 29 | +Since Wagtail is built on the Django framework, you can integrate all Django features and third-party plugins. For example, if you don't want to use Wagtail's built-in REST API, you can build your own using [Django REST framework](https://www.django-rest-framework.org). |
| 30 | + |
| 31 | +View the official Wagtail [Are we headless yet?](https://areweheadlessyet.wagtail.org/) website for an overview of Wagtail’s features for headless projects, such as: |
| 32 | + |
| 33 | +- The [REST API](https://areweheadlessyet.wagtail.org/rest-api) to access site contents. |
| 34 | +- Available [GraphQL packages](https://areweheadlessyet.wagtail.org/graphql). |
| 35 | +- How to process [rich text](https://areweheadlessyet.wagtail.org/rich-text) based upon the needs of the site generator. |
| 36 | +- And more details about common requirements, specific site generators, and hosting platforms. |
| 37 | + |
| 38 | +## GraphQL usage |
| 39 | + |
| 40 | +By using [wagtail-grapple](https://github.com/torchbox/wagtail-grapple), you can build GraphQL endpoints on a model-by-model basis as quickly as possible with a simple configuration. The library provides support for the following: |
| 41 | + |
| 42 | +- Annotation-based schema generation |
| 43 | +- Built-in support for Page, Snippets, Image, Documents, Media, Settings, Redirects models. |
| 44 | +- Search and pagination |
| 45 | +- Jamstack website preview functionality built with GraphQL subscriptions |
| 46 | + |
| 47 | +## Jamstack sites built with Wagtail |
| 48 | + |
| 49 | +Currently, there are governments, nonprofits, and publications using Wagtail on Jamstack. Here are prominent examples: |
| 50 | + |
| 51 | +- [NASA Jet Propulsion Laboratory](https://www.jpl.nasa.gov/) – Nuxt |
| 52 | +- [Hong Kong M+ Museum](https://www.mplus.org.hk/en/) – Nuxt |
| 53 | +- [Visit Sweden](https://visitsweden.com/) – Next.js |
| 54 | + |
| 55 | +## Popular Resources |
| 56 | + |
| 57 | +- [Are we headless yet?](https://areweheadlessyet.wagtail.org/) – Overview of all the ins and outs of Wagtail on the Jamstack. |
| 58 | +- [wagtail.org](https://wagtail.org/) – Official website. |
| 59 | +- [guide.wagtail.org](https://guide.wagtail.org/) – User documentation. |
| 60 | +- [docs.wagtail.org](https://docs.wagtail.org/) – Developer documentation. |
| 61 | +- [wagtail.org/roadmap](https://wagtail.org/roadmap) – Public roadmap. |
0 commit comments