User documentation
  1. What is redirection.io?
  2. Starter's guide
  3. What are organizations and projects?
  4. Invite new collaborators
  5. User account and preferences
  6. Using traffic logs
  7. Create a rule
  8. Triggers and markers reference
  9. Actions reference
  10. How to bulk-import or export redirection rules?
  11. Managing instances
  12. Project notifications
  13. Project segmentation
  14. How much does it cost?
  15. Can I use redirection.io for free?
  16. About us

Developer documentation
  1. TL;DR; Fast track
  2. Installation of the agent
  3. Upgrading the agent
  4. Agent configuration reference
  5. Available integrations
  6. The agent as a reverse proxy
  7. nginx module
  8. Apache module
  9. platform.sh integration
  10. Cloudflare Workers integration
  11. Fastly Compute@Edge integration
  12. Vercel Middleware Integration
  13. Using redirection.io with Docker
  14. How fast is it?
  15. Public API

Crawler
  1. What is the redirection.io crawler?
  2. Start a crawl
  3. Schedule a crawl
  4. Analyzing the results of a crawl
  5. The crawls list
  6. Crawl credits and pricing
  7. Crawl Errors
  8. Crawler metrics reference
  9. Crawler columns reference

Managed instances
  1. What are managed instances?
  2. Add a domain to your project
  3. Managed instances limits and quota
  4. Frequently asked questions

Knowledge base
  1. Create your first redirections
  2. redirection.io rules cookbook
  3. Setting up a redirection server on Azure Cloud
  4. Structured data and Rich Snippets
  5. What is a URL redirection?
  6. Why use URL redirections and how to setup

Legacy versions
  1. Agent 1.x configuration reference
  2. Legacy integrations
  3. Legacy Cloudflare Workers integration

Changelogs
  1. redirectionio-agent
  2. libnginx-mod-redirectionio
  3. libapache2-mod-redirectionio

Why use URL redirections and how to setup

Why would I want URL redirections?

There are many good reasons why a company would need http redirections to redirect the user from one URL to another:

  • the content previously available at one URL has changed of URL;
  • the url is automatically generated based on a metadata of the page content, which has changed (you fixed a typo in an article title, you changed a product's reference, etc.) and you don't have the possibility to force a content's url;
  • your company recently purchased a dedicated domain name for a specific product brand, or for a marketing campaign, and you need to redirect this domain to a precise page of your website;
  • your website has recently been redesigned 💥 which is often a source of major URL map revamp:
    • some contents may simply disappear, as you found that they're outdated, or you do not want to have those contents on your "new" website anymore;
    • developers may have changed the way URLs are generated to allow better and more readable URL formats. For example, developers could have decided to change the previously used URLs that contained technology extensions (index.php for instance) or content identifiers (?id=5468);
  • if you launch a new marketing campaign, you could want to print material with an easy-to-remember URL on it (mysuperproduct.com) instead of a cumbersome URLs within your website, which might be too long to be remember or printed.

In all these cases, it is of course required to create redirections, the only way of avoiding 404 responses on missing URLs.

How to set up web redirects?

There are several ways of creating a redirection:

  • at application level: you can create a redirection by writing application code (PHP, Ruby, Javascript, .Net, Java, Python, etc.) that will be executed by the webserver;
  • at infrastructure level: you can configure the web server (nginx, Apache, IIS, etc.) or other infrastructure parts (Varnish, Squid, etc.) to execute redirections on given URLs;
  • redirection.io: you can also just setup redirection.io on your website, and be able to manage redirection rules right in our manager interface.

The first two solutions are perfectly convenient, but have several drawbacks. First, they both require to involve developers or ops to set up the redirections, which is quite annoying for those and often introduces latency (while, in the same time, you would want your redirections to be available instantly...).

At application level, you also get the problem that your application gets hit by web requests even when a redirection has to be done. Hence, even if you have built an exhaustive redirection map for avoiding 404 errors, your application will receive a lot of trafic which could have been tackled in a lower layer of your infrastructure.

At infrastructure level, configuring redirections requires the help of a Sysadmin. In large hosting projects, this can involve some latency, ranging from days to weeks, before your redirection requirements are applied. Another drawback of this approach is the scalability: above some thousands of redirection rules, the webservers performance slightly slows down - you can expect more than a 90% drop in performance with large redirection plans, which is obviously not convenient.

redirection.io is the right answer to all of these issues: newly created redirection rules get applied in seconds without requiring any technical knowledge. Also, these rules are applied as soon as possible in the way of an incoming web request in your web stack, which means redirection.io can help save workload on your applicative web servers, logging systems or relational database storages.

This page has been updated on Jul 1, 2025
Can't find your answer?