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.

Source Distribution

django-seo2-1.0.1.tar.gz (597.3 kB view hashes)

Uploaded Source

Built Distribution

django_seo2-1.0.1-py2.py3-none-any.whl (25.9 kB view hashes)

Uploaded Python 2 Python 3

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