New Feature: Record expiration

netbox_dns/api/serializers_/record.py

@@ -41,6 +41,8 @@ class Meta:
             "tenant",
             "ipam_ip_address",
             "absolute_value",
+            "expiration_date",
+            "expired",
         )
 
         brief_fields = (
@@ -57,6 +59,7 @@ class Meta:
             "description",
             "managed",
             "active",
+            "expired",
         )
 
     url = serializers.HyperlinkedIdentityField(
@@ -102,3 +105,7 @@ class Meta:
         required=False,
         allow_null=True,
     )
+    expired = serializers.SerializerMethodField()
+
+    def get_expired(self, instance):
+        return instance.is_expired

netbox_dns/filtersets/record.py

@@ -1,6 +1,7 @@
 import django_filters
 import netaddr
 from django.db.models import Q
+from django.utils.timezone import datetime
 
 from ipam.models import IPAddress
 from netbox.filtersets import PrimaryModelFilterSet
@@ -73,6 +74,10 @@ class Meta:
         method="filter_ip_address",
     )
     active = django_filters.BooleanFilter()
+    expiration_date = django_filters.DateFromToRangeFilter()
+    expired = django_filters.BooleanFilter(
+        method="filter_expired",
+    )
 
     def filter_ip_address(self, queryset, name, value):
         if not value:
@@ -88,6 +93,12 @@ def filter_ip_address(self, queryset, name, value):
         except (netaddr.AddrFormatError, ValueError):
             return queryset.none()
 
+    def filter_expired(self, queryset, name, value):
+        if value:
+            return queryset.filter(expiration_date__lt=datetime.now())
+
+        return queryset.exclude(expiration_date__lt=datetime.now())
+
     def search(self, queryset, name, value):
         if not value.strip():
             return queryset

netbox_dns/forms/record.py

@@ -22,7 +22,7 @@
     TagFilterField,
 )
 from utilities.forms.rendering import FieldSet
-from utilities.forms.widgets import BulkEditNullBooleanSelect
+from utilities.forms.widgets import BulkEditNullBooleanSelect, DatePicker
 
 __all__ = (
     "RecordForm",
@@ -46,6 +46,7 @@ class Meta:
             "value",
             "status",
             "ttl",
+            "expiration_date",
             "disable_ptr",
             "tenant_group",
             "tenant",
@@ -57,6 +58,10 @@ class Meta:
             "ttl": _("TTL"),
         }
 
+        widgets = {
+            "expiration_date": DatePicker,
+        }
+
     fieldsets = (
         FieldSet(
             "name",
@@ -68,6 +73,7 @@ class Meta:
             "status",
             "ttl",
             "disable_ptr",
+            "expiration_date",
             name=_("Record"),
         ),
         FieldSet(
@@ -141,6 +147,8 @@ class RecordFilterForm(TenancyFilterForm, PrimaryModelFilterSetForm):
             "ttl",
             "disable_ptr",
             "active",
+            "expiration_date_before",
+            "expiration_date_after",
             name=_("Attributes"),
         ),
         FieldSet(
@@ -176,6 +184,16 @@ class RecordFilterForm(TenancyFilterForm, PrimaryModelFilterSetForm):
         widget=forms.Select(choices=BOOLEAN_WITH_BLANK_CHOICES),
         label=_("Disable PTR"),
     )
+    expiration_date_before = forms.DateField(
+        required=False,
+        label=_("Expiration Date Before"),
+        widget=DatePicker,
+    )
+    expiration_date_after = forms.DateField(
+        required=False,
+        label=_("Expiration Date After"),
+        widget=DatePicker,
+    )
     status = forms.MultipleChoiceField(
         choices=RecordStatusChoices,
         required=False,
@@ -221,6 +239,7 @@ class Meta:
             "value",
             "ttl",
             "disable_ptr",
+            "expiration_date",
             "tenant",
             "tags",
         )
@@ -302,6 +321,7 @@ class RecordBulkEditForm(PrimaryModelBulkEditForm):
             "status",
             "ttl",
             "disable_ptr",
+            "expiration_date",
             name=_("Attributes"),
         ),
         FieldSet(
@@ -315,6 +335,7 @@ class RecordBulkEditForm(PrimaryModelBulkEditForm):
         "description",
         "ttl",
         "tenant",
+        "expiration_date",
     )
 
     zone = DynamicModelChoiceField(
@@ -355,3 +376,8 @@ class RecordBulkEditForm(PrimaryModelBulkEditForm):
         required=False,
         label=_("Tenant"),
     )
+    expiration_date = forms.DateField(
+        required=False,
+        label=_("Expiration Date"),
+        widget=DatePicker,
+    )

netbox_dns/graphql/filters/record.py

@@ -1,9 +1,10 @@
+from datetime import date
 from typing import TYPE_CHECKING, Annotated
 
 import strawberry
 import strawberry_django
 from strawberry.scalars import ID
-from strawberry_django import FilterLookup
+from strawberry_django import DateFilterLookup, FilterLookup
 
 try:
     from strawberry_django import StrFilterLookup
@@ -58,6 +59,7 @@ class NetBoxDNSRecordFilter(
         | None
     ) = strawberry_django.filter_field()
     value: StrFilterLookup[str] | None = strawberry_django.filter_field()
+    expiration_date: DateFilterLookup[date] | None = strawberry_django.filter_field()
     disable_ptr: FilterLookup[bool] | None = strawberry_django.filter_field()
     status: (
         Annotated[

netbox_dns/migrations/0032_record_expiration_date.py

@@ -0,0 +1,17 @@
+# Generated by Django 6.0.5 on 2026-06-07 10:07
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("netbox_dns", "0031_record_netbox_dns_record_name_and_more"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="record",
+            name="expiration_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+    ]

netbox_dns/models/record.py

@@ -1,4 +1,5 @@
 import ipaddress
+from datetime import date
 
 import dns
 import netaddr
@@ -144,6 +145,7 @@ class Meta:
         "disable_ptr",
         "description",
         "tenant",
+        "expiration_date",
     )
 
     def __init__(self, *args, **kwargs):
@@ -258,6 +260,11 @@ def __str__(self):
         null=True,
         blank=True,
     )
+    expiration_date = models.DateField(
+        verbose_name=_("Expiration Date"),
+        blank=True,
+        null=True,
+    )
 
     @property
     def cleanup_ptr_record(self):
@@ -307,6 +314,13 @@ def is_active(self):
             and self.zone.status in ZONE_ACTIVE_STATUS_LIST
         )
 
+    @property
+    def is_expired(self):
+        if self.expiration_date is None:
+            return False
+
+        return self.expiration_date < date.today()
+
     @property
     def is_address_record(self):
         return self.type in (RecordTypeChoices.A, RecordTypeChoices.AAAA)

netbox_dns/tables/record.py

@@ -73,6 +73,7 @@ class Meta(PrimaryModelTable.Meta):
         fields = (
             "status",
             "description",
+            "expiration_date",
         )
 
         default_columns = (

netbox_dns/templates/netbox_dns/record.html

@@ -39,11 +39,11 @@
 {% block content %}
 <div class="row">
     {% if object.managed %}
-    <div class="col col-md-12">
+        <div class="col col-md-12">
     {% else %}
-    <div class="col col-md-8">
+        <div class="col col-md-8">
     {% endif %}
-        <div class="card">
+    <div class="card">
             <h5 class="card-header">{% trans "Record" %}</h5>
             <table class="table table-hover attr-table">
                 <tr>
@@ -117,6 +117,18 @@ <h5 class="card-header">{% trans "Record" %}</h5>
                     <td>{% checkmark object.disable_ptr %}</td>
                 </tr>
                 {% endif %}
+                {% if object.expiration_date %}
+                    <tr>
+                        <th scope="row">{% trans "Expiration Date" %}</th>
+                        <td>{{ object.expiration_date|isodate }}</td>
+                    </tr>
+                    {% if expiration_warning %}
+                        <tr class="text-warning">
+                            <th scope="row">{% trans "Warning" %}</th>
+                            <td>{{ expiration_warning }}</td>
+                        </tr>
+                    {% endif %}
+                {% endif %}
                 {% if object.ptr_record %}
                 <tr>
                     <th scope="row">{% trans "PTR Record" %}</th>
@@ -149,52 +161,52 @@ <h5 class="card-header">{% trans "Record" %}</h5>
                 </tr>
             </table>
         </div>
-        {% if rrset_record_table %}
-            <div class="card">
-                {% if rrset_record_table.rows|length == 1 %}
-                    <h5 class="card-header">{% trans "Other Record in the RRSET" %}</h5>
-                {% else %}
-                    <h5 class="card-header">{% trans "Other Records in the RRSET" %}</h5>
-                {% endif %}
-                <div class="table-responsive">
-                    {% render_table rrset_record_table 'inc/table.html' %}
-                </div>
+    {% if rrset_record_table %}
+        <div class="card">
+            {% if rrset_record_table.rows|length == 1 %}
+                <h5 class="card-header">{% trans "Other Record in the RRSET" %}</h5>
+            {% else %}
+                <h5 class="card-header">{% trans "Other Records in the RRSET" %}</h5>
+            {% endif %}
+            <div class="table-responsive">
+                {% render_table rrset_record_table 'inc/table.html' %}
             </div>
-        {% endif %}
-        {% if cname_target_table %}
-            <div class="card">
-                {% if cname_target_table.rows|length == 1 %}
-                    <h2 class="card-header">{% trans "CNAME Target" %}</h2>
-                {% else %}
-                    <h2 class="card-header">{% trans "CNAME Targets" %}</h2>
-                {% endif %}
-                <div class="table-responsive">
-                    {% render_table cname_target_table 'inc/table.html' %}
-                </div>
+        </div>
+    {% endif %}
+    {% if cname_target_table %}
+        <div class="card">
+            {% if cname_target_table.rows|length == 1 %}
+                <h2 class="card-header">{% trans "CNAME Target" %}</h2>
+            {% else %}
+                <h2 class="card-header">{% trans "CNAME Targets" %}</h2>
+            {% endif %}
+            <div class="table-responsive">
+                {% render_table cname_target_table 'inc/table.html' %}
             </div>
-        {% elif cname_table %}
-            <div class="card">
-                {% if cname_table.rows|length == 1 %}
-                    <h2 class="card-header">{% trans "CNAME" %}</h2>
-                {% else %}
-                    <h2 class="card-header">{% trans "CNAMEs" %}</h2>
-                {% endif %}
-                <div class="table-responsive">
-                    {% render_table cname_table 'inc/table.html' %}
-                </div>
+        </div>
+    {% elif cname_table %}
+        <div class="card">
+            {% if cname_table.rows|length == 1 %}
+                <h2 class="card-header">{% trans "CNAME" %}</h2>
+            {% else %}
+                <h2 class="card-header">{% trans "CNAMEs" %}</h2>
+            {% endif %}
+            <div class="table-responsive">
+                {% render_table cname_table 'inc/table.html' %}
             </div>
-        {% endif %}
-        {% if not object.managed %}
+        </div>
+    {% endif %}
+    {% if not object.managed %}
         {% include 'inc/panels/custom_fields.html' %}
         {% include 'inc/panels/comments.html' %}
         {% plugin_left_page object %}
-        {% endif %}
+    {% endif %}
     </div>
     {% if not object.managed %}
-    <div class="col col-md-4">
-        {% include 'inc/panels/tags.html' %}
-    </div>
-    {% plugin_right_page object %}
+        <div class="col col-md-4">
+            {% include 'inc/panels/tags.html' %}
+        </div>
+        {% plugin_right_page object %}
     {% endif %}
 </div>
 <div class="row">