---
title: '|urlencode'
description: escapes a string for use in a URL.
date: '2026-08-02'
categories:
  - Filter
  - URL
canonical: https://www.djangotemplatetagsandfilters.com/filters/urlencode/
doc_link: https://docs.djangoproject.com/en/6.0/ref/templates/builtins/#urlencode
---

# |urlencode

escapes a string for use in a URL.

## Documentation

Escapes a string for use in a URL.

### Variable

```django
url = 'https://www.webucator.com/search/search.cfm?q=django'
```

### Template

```django
{{ url|urlencode }}
```

### Result

```django
https%3A//www.webucator.com/search/search.cfm%3Fq%3Ddjango
```

Forward slashes (`/`) are not escaped by default. To escape all special characters, pass an empty string (`""`) for the argument.

### Additional Examples

```django
{{ url|urlencode:"/" }}
{{ url|urlencode:"" }}
{{ url|urlencode:":" }}
```

### Results

```django
https%3A//www.webucator.com/search/search.cfm%3Fq%3Ddjango
https%3A%2F%2Fwww.webucator.com%2Fsearch%2Fsearch.cfm%3Fq%3Ddjango
https:%2F%2Fwww.webucator.com%2Fsearch%2Fsearch.cfm%3Fq%3Ddjango
```

## Commentary

The `urlencode` filter can be used for passing URL parameters back to the querystring in generated links. For example:

```django
<a href="?page=1&ordering={{ request.GET.ordering|urlencode }}">1</a>
```