Django Classified

Features

Item groups, categories and areas (for ex. Cities or Locations)
Image
upload multiple images per item
generating preview (via sorl-thumbnail)
display in a Bootstrap 5 modal with a carousel
Search ability
SEO
SEO-friendly URLs, including non-Latin characters (Arabic, Cyrillic, etc.)
sitemap.xml covering both item and category pages
Self-referencing canonical URLs
Per-page meta descriptions, including category pages
JSON-LD structured data (Product, BreadcrumbList) on item pages
Open Graph and Twitter card tags
robots.txt, and noindex on search, profile and form pages
<html lang> follows the active translation
RSS feed
Google Analytics 4 (GA4) integration
Caching of robots.txt and the RSS feed
Translation
Arabic
Azerbaijani
English
French (thanks to Teolemon)
German
Polish
Portuguese
Russian
Spanish (thanks to 4bimcad)
Turkish (thanks to Mirat Can Bayrak)
Help translate to other languages at Transifex

Requirements

Python >=3.10
Django >=5.2, <6.1

Design

Bootstrap 5.3
No external requests: no jQuery, no CDN, no webfonts. The only script is Bootstrap's own bundle, and typography uses system font stacks.
Light and dark themes via Bootstrap's data-bs-theme attribute
Accessible defaults: visible focus styles, prefers-reduced-motion respected, and a print stylesheet

All templates live under django_classified/templates/django_classified/ and can be overridden by placing a file of the same name earlier on the template path.

Demo project

Demo project with user registration (via Email/Facebook) available here.

Installation

Install app pip install django-classified
Add django_classified to the INSTALLED_APPS:

INSTALLED_APPS = [
    # Default Django applications
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.messages',
    'django.contrib.sessions',
    'django.contrib.staticfiles',

     # Required by Django Classified
    'django.contrib.sites',
    'django.contrib.humanize',
    'django.contrib.sitemaps',

     # External applications required by Django Classified
    'sorl.thumbnail',

    # Django Classified
    'django_classified',
]

Add SITE_ID to settings.py file:

SITE_ID = 1

Import include in addition to path and add path('', include('django_classified.urls', namespace='django_classified')), to the project urls.py file:

from django.urls import path, include

urlpatterns = [
    path('', include('django_classified.urls', namespace='django_classified')),
]

Add 'django_classified.context_processors.common_values' to the settings TEMPLATES context_processors list:

TEMPLATES[0]['OPTIONS']['context_processors'].append('django_classified.context_processors.common_values')

Customization:

You can provide additional customization in settings.py

DCF_SITE_NAME - Site title
DCF_SITE_DESCRIPTION - Site description
DCF_ITEM_PER_USER_LIMIT - Max Items allowed per user
DCF_SITEMAP_LIMIT - Sitemap items limit
DCF_RSS_LIMIT - RSS feed items limit
DCF_RELATED_LIMIT - Number of related items displayed
DCF_ITEM_PER_PAGE - Number of items per page
DCF_LOGIN_TO_CONTACT - Hide contact information for unauthorized requests
DCF_DISPLAY_EMPTY_GROUPS - Display groups without items in the groups list
DCF_DISPLAY_CREDITS - Show the "Powered by Django Classified" footer credit (default: True)
DCF_CURRENCY - Site currency (default: 'USD')

Optional integrations

GOOGLE_ANALYTICS_PROPERTY_ID - Google Analytics 4 measurement ID (e.g. 'G-XXXXXXXXXX')
GOOGLE_SITE_VERIFICATION_ID - Google Search Console verification code
FACEBOOK_APP_ID - Facebook App ID for Open Graph integration

Upgrading to 1.3

1.3 migrates the bundled templates from Bootstrap 3 to Bootstrap 5 and removes several dependencies. If you use the templates as shipped, upgrading with pip install -U django-classified is all you need. Otherwise:

Remove 'bootstrapform' from INSTALLED_APPS. django-bootstrap-form is no longer a dependency, so leaving it listed raises ModuleNotFoundError. The bootstrap template filter is now provided by this package and keeps its name, so {% load i18n bootstrap %} still works.
If you override any bundled template, it is now Bootstrap 5 markup. The old Bootstrap 3 classes (form-group, control-label, help-block, pull-right, btn-default, glyphicons) are gone.
These static files were removed: jQuery, lightbox2, the Glyphicons fonts, jumbotron-narrow.css, and bootstrap.min.css.map. Reference them from your own project if you still need them.
Item images now open in a Bootstrap modal with a carousel instead of lightbox2.

See changelog.txt for the full list.

Current Version

The current version is 1.3 (July 2026).