Skip to content

[DEPR]: react-helmet and methods that modify <head> directly #415

@arbrandes

Description

@arbrandes

RFC Start Date

2025-08-01

Target Plan Accepted Date

2025-08-15

Target Transition Unblocked Date

October 2025

Earliest Breaking Changes Unblocked Date

January 2026

Earliest Open edX Named Release with Breaking Changes

Verawood - 2026-04

Rationale

Once a frontend app is converted to frontend-base, it is expected to be loaded as one of many such packages in a proper SPA. In other words, index.html now applies to several apps, not just one. As such, it no longer makes sense to expect each app to modify the header.

Furthermore, each deployment's index.html is now entirely part of site configuration, so there's no need to have code alter it dynamically.

As such, we're deprecating the use of react-helmet and any other methods that modify <head> items directly.

Removal

Any uses of react-helmet or any other methods that modify <head> items directly.

Replacement

The way frontend-base deployments work allow operators to modify index.html directly, and to maintain those modifications under version control. See https://github.com/openedx/frontend-template-site.

Deprecation

No response

Additional Info

No response

Task List

No response

Task List

No response

Metadata

Metadata

Assignees

Labels

deprProposal for deprecation & removal per OEP-21

Type

No type

Projects

Status

Draft

Status

In Progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions