Skip to main content

Ocha Humanitarian Icons, for use in Wagtail projects, with an icon chooser widget.

Project description

Wagtail Humanitarian Icons

This Wagtail package brings Ocha Humanitarian Icons to Wagtail Admin.

NOTE: The recent versions of Wagtail supports uploading SVGs directly to the images section of the CMS interface. If you just need to upload SVG images and use them on you frontend, consider using that. This package aims to provide a way to select and use predefined humanitarian icons from OCHA.


pip install wagtail-humanitarian-icons

Add wagtailhumanitarianicons to your installed apps



This package uses the Wagtail register_icons hook to register all the Ocha Humanitarian svg icons. For more details on how this works, please look at the Wagtail Docs and the file of this package

You can find a list of all the icons in the file wagtailhumanitarianicons/icons.json. You can refer any icon by the name, without the .svg extension.

The best way to visually choose an icon is to use the package wagtail-icon-chooser as below:

  • First install the wagtail-icon-chooser package
pip install wagtal-icon-chooser
  • Add to wagtailiconchooser to your installed apps

Then you can use the widgets provided by wagtal-icon-chooser. Refer the package docs for specific details on how to use the widgets, and how to show selected icons on your frontend templates.

Have a look on the sandbox/home/ for a complete example, and sandbox/home/templates for an example on rendering on the frontend.

The code used to prepare the OCHA icons can be found at wagtailhumanitarianicons/

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

wagtail-humanitarian-icons-2.0.0.tar.gz (99.4 kB view hashes)

Uploaded source

Built Distribution

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