This document is for Django's SVN release, which can be significantly different from previous releases. Get old docs here: Django 1.0
Django documentation¶
Everything you need to know about Django (and then some).
Getting help¶
Having trouble? We’d like to help!
- Try the FAQ – it’s got answers to many common questions.
- Looking for specific information? Try the Index, Module Index or the detailed table of contents.
- Search for information in the archives of the django-users mailing list, or post a question.
- Ask a question in the #django IRC channel, or search the IRC logs to see if its been asked before.
- Report bugs with Django in our ticket tracker.
The model layer¶
- Models: Model syntax | Field types | Meta options
- QuerySets: Executing queries | QuerySet method reference
- Model instances: Instance methods | Accessing related objects
- Advanced: Managers | Raw SQL | Transactions | Aggregation | Custom fields
- Other: Supported databases | Legacy databases | Providing initial data
The template layer¶
- For designers: Syntax overview | Built-in tags and filters
- For programmers: Template API | Custom tags and filters
The view layer¶
- The basics: URLconfs | View functions | Shortcuts
- Reference: Request/response objects
- File uploads: Overview | File objects | Storage API | Managing files | Custom storage
- Generic views: Overview | Built-in generic views
- Advanced: Generating CSV | Generating PDF
- Middleware: Overview | Built-in middleware classes
Forms¶
- The basics: Overview | Form API | Built-in fields | Built-in widgets
- Advanced: Forms for models | Integrating media | Formsets | Customizing validation
- Extras: Form preview | Form wizard
The development process¶
- Settings: Overview | Full list of settings
- django-admin.py and manage.py: Overview | Adding custom commands
- Testing: Overview
- Deployment: Overview | Apache/mod_wsgi | Apache/mod_python | FastCGI/SCGI/AJP | Apache authentication | Serving static files | Tracking code errors by e-mail
Other batteries included¶
- Admin site | Admin actions
- Authentication
- Cache system
- Conditional content processing
- Comments | Moderation | Custom comments
- Content types
- Cross Site Request Forgery protection
- Databrowse
- E-mail (sending)
- Flatpages
- Humanize
- Internationalization
- Jython support
- “Local flavor”
- Pagination
- Redirects
- Serialization
- Sessions
- Signals
- Sitemaps
- Sites
- Syndication feeds (RSS/Atom)
- Unicode in Django
- Web design helpers
The Django open-source project¶
- Community: How to get involved | The release process | Team of committers
- Design philosophies: Overview
- Documentation: About this documentation
- Third-party distributions: Overview
- Django over time: API stability | Archive of release notes | Backwards-incompatible changes
Questions/Feedback
Having trouble? We'd like to help!
- Try the FAQ — it's got answers to many common questions.
- Search for information in the archives of the django-users mailing list, or post a question.
- Ask a question in the #django IRC channel, or search the IRC logs to see if its been asked before.
- If you notice errors with this documentation, please open a ticket and let us know! Please only use the ticket tracker for criticisms and improvements on the docs. For tech support, use the resources above.

