From 94652a4dbb6173a4a22a3fb99ea2301e9de18242 Mon Sep 17 00:00:00 2001
From: Matt Rahill <matt.rahill@nlr.gov>
Date: Mon, 9 Mar 2026 14:41:40 -0600
Subject: [PATCH] add a page about updating embed code for NLR.gov widgets

---
 source/docs/nlr-domain-transition.html.md |  1 +
 source/docs/widget-embed-code.html.md     | 20 ++++++++++++++++++++
 source/layouts/layout.erb                 | 15 ++++++++++-----
 3 files changed, 31 insertions(+), 5 deletions(-)
 create mode 100644 source/docs/widget-embed-code.html.md

diff --git a/source/docs/nlr-domain-transition.html.md b/source/docs/nlr-domain-transition.html.md
index c7e8dcb7..18c71de5 100644
--- a/source/docs/nlr-domain-transition.html.md
+++ b/source/docs/nlr-domain-transition.html.md
@@ -1,6 +1,7 @@
 ---
 title: NLR.gov Domain Transition
 hidden_child: true
+hide_domain_transition_link: true
 ---
 
 # NLR.gov Domain Transition
diff --git a/source/docs/widget-embed-code.html.md b/source/docs/widget-embed-code.html.md
new file mode 100644
index 00000000..3038ca65
--- /dev/null
+++ b/source/docs/widget-embed-code.html.md
@@ -0,0 +1,20 @@
+---
+title: Updating Embed Code for NLR.gov Widgets
+hidden_child: true
+hide_domain_transition_alert: true
+---
+
+<div class="alert alert-warning d-flex align-items-center" role="alert">
+  <i class="fa-solid fa-triangle-exclamation bi flex-shrink-0 me-2"></i>
+  <p class="m-0 lh-sm">
+    <strong>Website Owners:</strong> Update any <code>nrel.gov</code> references in your widget embed code to <code>nlr.gov</code> by <strong>May 29, 2026</strong>, to avoid service interruptions.
+  </p>
+</div>
+
+# Updating Embed Code for NLR.gov Widgets
+
+The National Laboratory of the Rockies (NLR) is retiring the `nrel.gov` domain near the end of May and transitioning to the new `nlr.gov` domain.
+
+**To avoid an interruption in service, you need to update your widget embed code to use the new `nlr.gov` URLs by May 29, 2026.** In your widget embed code, change `nrel.gov` to `nlr.gov` instead. All other aspects of the embed code remain the same.
+
+To find new embed code, use the [widgets page](https://afdc.energy.gov/widgets). We will display a message at the top of widgets about this change for website owners who haven't updated their embed code starting on April 13, 2026.
diff --git a/source/layouts/layout.erb b/source/layouts/layout.erb
index fa84b6c1..4844c251 100644
--- a/source/layouts/layout.erb
+++ b/source/layouts/layout.erb
@@ -34,12 +34,17 @@
     <main id="content" class="container-xl">
       <%= partial("layouts/breadcrumbs") %>
 
-      <div class="alert alert-warning d-flex align-items-center" role="alert">
-        <i class="fa-solid fa-triangle-exclamation bi flex-shrink-0 me-2"></i>
-        <p class="m-0 lh-sm">
-        <strong>Existing API users:</strong> Update any <code>developer.nrel.gov</code> references in your code to <code>developer.nlr.gov</code> by <strong>April 30, 2026</strong>, to avoid service interruptions. Learn more about the <%= link_to("domain transition", "/docs/nlr-domain-transition.html") %>.
+      <% unless current_page.data.hide_domain_transition_alert %>
+        <div class="alert alert-warning d-flex align-items-center" role="alert">
+          <i class="fa-solid fa-triangle-exclamation bi flex-shrink-0 me-2"></i>
+          <p class="m-0 lh-sm">
+            <strong>Existing API Users:</strong> Update any <code>developer.nrel.gov</code> references in your code to <code>developer.nlr.gov</code> by <strong>April 30, 2026</strong>, to avoid service interruptions.
+            <% unless current_page.data.hide_domain_transition_link %>
+              Learn more about the <%= link_to("domain transition", "/docs/nlr-domain-transition.html") %>.
+            <% end %>
+          </p>
         </div>
-      </div>
+      <% end %>
 
       <%= yield %>