Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

URL Rewrite

No security coverage Under active development 1 sites

This module rewrites old URLs to new URLs within HTML output before it's sent to the browser. It helps manage URL changes across a site by automatically updating links in content and other areas, without requiring manual edits everywhere.

Overview

Rewrites old URLs to new URLs in HTML output at render time. Any href attribute that matches a configured "old" path is replaced with the "new" path before the page is sent to the browser.

Use case

When changing URL structure across the site, links may still appear in many places (content body, link fields, views, templates, etc.). This module rewrites them in one place at response time so you don't have to update every occurrence.

Configuration

  • Configuration path: Admin → Configuration → System → URL Rewrite (/admin/config/system/url-rewrite)
  • Enable/disable: Turn rewriting on or off.
  • Skip admin: When enabled, no rewriting is done on paths under /admin.
  • URL mappings: The source of truth. Add From (old path) and To (new path) rows. Drupal uses these for rewriting at render time.
  • Generate JSON file at path (for other site): Optional. When set, saving the form writes a JSON file at this path (relative to Drupal root) with the same mappings. Share this file with WordPress so it can use the same rewrite rules.

Generated JSON format

When you set "Generate JSON file at path" and save, the module writes a file in this format:

{
  "mappings": [
    { "from": "/blog", "to": "/articles" },
    { "from": "/success-stories", "to": "/case-studies" }
  ]
}

WordPress can read this file and apply the same rewrite logic. Paths are matched by prefix: longest match wins (e.g. /blog before /articles).

  • Query strings and fragments are preserved.
  • Works for both absolute URLs (e.g. https://example.com/old-path) and relative URLs (/old-path).

Performance

  • Only runs on HTML responses.
  • Mappings from a JSON file are cached (invalidated when the file is updated).
  • A single pass over the response body replaces only href attribute values.
Drupal 10–11

Ask your assistant about URL Rewrite

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
1
Tracked since
Jun 2026
Latest release
4 months ago
Releases (12 mo)
1 ▲ from 0
Maintenance
Active

Releases

Version Type Core PHP Release date
1.0.0 Stable 10–11 Jun 30, 2026