Skip to main content

A framework for managing SEO metadata in Django.

Project description Documentation Status


This is a set of powerful and flexible SEO tools for Django. It allows you to associate metadata with:

  • absolute paths
  • model instances
  • model classes
  • views

Metadata can be edited in the Django Admin in a centralised place, but also alongside any associated models.

This is however a framework, not an app. To use this library, you need to define the metadata you want and add the output to your templates. Everything else (retrieval, formatting, escaping, caching) is handled for you. Therefore, you have complete control over the data you store.

As requirements change, it may become necessary to add new metadata fields. Having the metadata definition confined to a single, short class means that it is easy to update.


  • Python (2.7, 3.3, 3.4, 3.5)
  • Django (1.7, 1.8, 1.9)


Here is an example of a definition:

from djangoseo import seo

class BasicMetadata(seo.Metadata):
    title = seo.Tag(max_length=68, head=True)
    keywords = seo.KeywordTag()
    description = seo.MetaTag(max_length=155)
    heading = seo.Tag(name="h1")
    subheading = seo.Tag(name="h2")
    extra = seo.Raw(head=True)

    # Adding some fields for facebook (opengraph)
    og_title = seo.MetaTag(name="og:title",
                           verbose_name="facebook title")

    og_description = seo.MetaTag(name="og:description",
                                 verbose_name='facebook description')

As you can see it is very flexible, but there is much more than this simple example.

The full documentation can be read online at


This is a fork of django-seo, which is no longer maintained.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_seo2-1.0.1-py2.py3-none-any.whl (25.9 kB) Copy SHA256 hash SHA256 Wheel 2.7
django-seo2-1.0.1.tar.gz (597.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page