Skip to main content

A Django URL shortening app

Project description

A URL shortening app written in Django.

Shortened URLs will work at either or (i.e. the short path can either be in the URL, or a subdomain).

Quick Start

Get started with Shorty by following these steps:

  • Install djshorty with pip:

    pip install djshorty
  • Add shorty to your INSTALLED_APPS in

  • Either set short.urls as your ROOT_URLCONF, or include it in your own

  • Shorty relies on django-autoconfig, which requires the following at the end of

    from django_autoconfig.autoconfig import configure_settings


Shorty provides the following settings:

  • SHORTY_EXTERNAL_FLAG: If Shorty is deployed in a corporate environment, and you want the ability for some short URLs to resolve outside the company and others to remain internal, set this to True. URLs not marked as ‘external’ will require authentication. This is designed to work with a Single Sign On solution.

  • SHORTY_CANONICAL_DOMAIN: Set this to normalise the domain before redirection. This is useful if you have multiple domains, but the SSO system (see above) requires a single domain to work. For example, if Shorty is primarily deployed at<short-url>, but you also allow short URLs to resolve at https://<short-url>, you may need to set this to ''. It should include the scheme (http or https), and not end with a trailing slash.


To contribute, fork the repo, do your work, and issue a pull request. We ask that contributors adhere to PEP8 standards, and include full tests for all their code.

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

djshorty-0.5.2.tar.gz (12.7 kB view hashes)

Uploaded source

Built Distributions

djshorty-0.5.2-py3-none-any.whl (13.7 kB view hashes)

Uploaded py3

djshorty-0.5.2-py2-none-any.whl (13.7 kB view hashes)

Uploaded py2

Supported by

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