Skip to main content

A minimal wedding registry or gift registry app.

Project description

Create a list of gifts ideas that can then be reserved by guests.

Guests can browse the list of gift ideas and reserve one by entering their email address. The item is then marked as chosen for the information of other guests. No registration is required, just an email address to send confirmation.

Gifts ideas can be either items that you only want one of, or items that you would be happy to receive multiples of (eg. a gift voucher). You can add a picture, description and URL for each item.

The registry doesn’t take payment or allow the gift to be directly purchase, it simply allows gift ideas to be reserved.

Quick start

  1. Add the following required Django settings:

    SITE_ID = 1
        'EVENT_NAME': "Alice and Bob's Wedding",
  2. Include the gifts URLconf in your project like this:

    path('', include('gift_registry.urls')),

    and a line to serve uploaded media in development:

    from django.conf import settings
    from django.conf.urls.static import static
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  3. Run python migrate to create the Gift Registry models.

  4. Run python createsuperuser --username=admin

  5. Start the development server and visit the Django Admin at to add gift ideas.

  6. Visit to browse the public list.

  7. Before deployment, be sure to add a “Site” via the Django Admin to ensure the outgoing emails include the correct link back to the website.


There’s a good chance that you’ll want to customise the look and feel. You do this by overriding the built-in templates.

Add your own template directory to settings.TEMPLATE_DIRS and override the base template here. To do this, first create a gift_registry directory in your templates directory. Then from within the django-gift-registry package, copy gift_registry/templates/gift_registry/base.html into your newly created gift_registry directory. Customise this base.html file with your own HTML and CSS.

Release History

0.5.3 (2021-09-22)

Upgraded for Python 3 and Django 3.2.

0.4.3 (2015-08-04)

Initial version.

Project details

Download files

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

Files for django-gift-registry, version 0.5.3
Filename, size File type Python version Upload date Hashes
Filename, size django_gift_registry-0.5.3-py3-none-any.whl (52.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-gift-registry-0.5.3.tar.gz (51.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page