Skip to main content
Skip table of contents

VA.gov to Subdomain Redirect

Last Updated: October 22, 2024

This document helps you understand the process of a VA.gov to Subdomain redirect. This is a page-level cross-domain redirect. For more information about redirects, return to the Redirect Implementation Strategy page.

The Sitewide Content, Accessibility & Information Architecture team (CAIA) reviews all URL redirects before routing them to the appropriate engineer.

Before you attempt a redirect, follow these two important steps:

  1. File a redirect request ticket on GitHub.

  2. Read the Design System guidance for redirects.

This is a server-side redirect

VA.gov to Subdomain redirects are server-side redirects. A server-side redirect sends a status code to the browser. This status code lets the browser know that the requested page has moved – or is no longer available – and points the browser toward the page’s new URL. Server-side redirects can be temporary or permanent.

Server-side redirects are preferred.

Information Table: VA.govto Subdomain Redirects

Below is a table that outlines the details of a VA.gov to Subdomain redirect.

VA.gov to Subdomain: Page-level cross-domain redirect

When to use this redirect:

When a single page within VA.gov needs to be redirected to a subdomain.

Real world example:

www.va.gov/coronavirus-research/

redirects to

http://www.research.va.gov/for_veterans/

How it works:

Traffic to VA.gov hits the VA gateway. Traffic is then routed to our reverse proxy and redirected.

Code example:

https://github.com/department-of-veterans-affairs/vsp-platform-revproxy/blob/c84e166395eb60db7614ceb2c5877b69accac03c/template-rendering/revproxy-vagov/vars/redirects.yml#L5925C1-L5926C52

Additional Info:

Refer to the revproxy README for more information on conventions and considerations, such as trailing slashes, child pages, and case sensitivity.

Team Responsibilities:

CAIA must sign off on request.

Additional Resources


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.