| RFC 10091 | EPP Extension Registry | November 2026 |
| Hollenbeck | Best Current Practice | [Page] |
The Extensible Provisioning Protocol (EPP) includes features to add functionality by extending the protocol. It does not, however, describe how those extensions are maintained. This document describes a procedure for the registration and management of extensions to EPP, and it specifies a format for an IANA registry to record those extensions. This document obsoletes RFC 7451.¶
This memo documents an Internet Best Current Practice.¶
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on BCPs is available in Section 2 of RFC 7841.¶
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc10091.¶
Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
Domain name registries implement a variety of operational and business models. The differences in these models make it impossible to develop a "one size fits all" provisioning protocol; the Extensible Provisioning Protocol [STD69] was designed to focus on a minimal set of common functionality with built-in extension capabilities that allow new features to be specified on an "as needed" basis. Guidelines for extending EPP are documented in [RFC3735] (or its future replacement).¶
[STD69] and [RFC3735] do not describe how extension development can be managed and coordinated. This has led to a situation in which server operators can develop different extensions to address similar needs, such as the provisioning of Value Added Tax (VAT) information. Clients then need to support multiple extensions that serve similar purposes, and interoperability suffers as a result.¶
[RFC7451] filled that gap by defining the "Extensions for the Extensible Provisioning Protocol (EPP)" IANA registry [IANA-REG] to help manage and coordinate the development of EPP extensions.¶
This document addresses issues that were identified with [RFC7451] over time. Refer to Section 1.1 for more details.¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
This section describes the format of the Extensions for the Extensible Provisioning Protocol (EPP) IANA registry [IANA-REG] and the procedures used to populate and manage registry entries.¶
This registry uses the "Specification Required" policy described in [RFC8126]. Note that Section 2.1 of [RFC3735] (or its future replacement) provides specific guidelines for documenting EPP extensions.¶
The "Specification Required" policy requires review by a designated expert. Section 5 of [RFC8126] describes the role of designated experts and the function they perform. For this registry, acceptable specifications include RFC documents and proprietary specifications that meet the "permanent and readily available" requirement described in Section 4.6 of [RFC8126]. An English language version of the extension specification MUST be referenced from the registry, though non-English versions of the specification may also be provided. Internet-Draft documents are not acceptable specifications for future registrations. Early allocations [RFC7120] do not apply to the Extensions for the EPP IANA registry [IANA-REG].¶
Section 5.2 of [RFC8126] describes the role of designated experts. This section describes how the practices described in [RFC8126] are applied for evaluation of EPP extension registration requests.¶
The IESG should appoint a primary designated expert and a small number of individuals (perhaps 3 - 5) to serve as backup designated experts as described in Section 5.2 of [RFC8126]. The primary designated expert is responsible for conducting all reviews requested by IANA. The secondary designated experts are responsible for conducting reviews as a simple majority, consensus-based group if the primary designated expert is unavailable. In cases where a registration decision could be perceived as creating a conflict of interest for a particular Designated Expert, that Expert MUST defer to the judgment of the other Experts. The designated experts MUST use the existing regext mailing list (regext@ietf.org) or its successor for public discussion of registration requests.¶
Extensions should be evaluated for architectural soundness using the guidelines described in [RFC3735] (or its future replacement), including the Security Considerations section of that document. Expert evaluation should explicitly include consideration of the privacy consequences of proposed extensions, and, at a minimum, ensure that any privacy considerations are fully documented in the relevant specification(s).¶
URIs proposed in extensions (XML namespace and schema registration requests are commonly found in EPP extensions) should be evaluated for both syntactic and semantic correctness. XML schemas, XML schema URIs, and XML namespace URIs defined in the extension specification MUST be registered in the "IETF XML Registry" using the procedures described in [RFC3688]. IETF namespaces MUST be reserved for specifications published in the IETF Stream. Non-IETF namespaces MUST be used for non-IETF specifications (which includes RFC documents produced by all non-IETF streams); the designated experts may need to work with a registrant to identify URIs that can be added to the "IETF XML Registry". Extensions and any normative references necessary to implement the extensions MUST NOT be denoted with "work in progress" or any similar description. Issues discovered during the evaluation MUST be shared with, and can be corrected by, the registrant until the designated experts explicitly decide to accept or reject the registration request.¶
Designated experts should be permissive in their evaluation of requests to register extensions that have been implemented and deployed by at least one registry/registrar or server/client pair. This implies that it may indeed be possible to register multiple extensions that provide the same functionality. Requests to register extensions that have not been deployed should be evaluated with a goal of reducing functional duplication. A potential registrant who submits a request to register a new, undeployed extension that includes similar functionality to an existing, registered extension should be made aware of the existing extension. The registrant should be asked to reconsider their request given the existence of a similar extension. Should they decline to do so, perceived similarity SHOULD NOT be a sufficient reason for rejection as long as all other requirements are met.¶
The registry contains information describing each registered extension. Registry entries are created and managed by sending forms to IANA that describe the extension and the operation to be performed on the registry entry.¶
Notes: Either "None" or other text that describes optional notes to be included with the registered extension. If the Status value is being changed, text MUST be included to describe the rationale for the status change.¶
The required information MUST be provided using the following registration form. Form field names and values MAY appear on the same line.¶
Example form with RFC specification:¶
Example form with non-RFC specification:¶
Registrants should send each registration form to IANA with a single record for incorporation into the registry (see <https://www.iana.org/assignments/epp-extensions>). Send the form via email to <iana@iana.org> or complete the online form. The subject line MUST indicate the type of request by including one of the following:¶
Removal of registrations created through IETF consensus MUST be approved by the IESG using the IESG Approval process described in Section 4.10 of [RFC8126]. Registrations not created through IETF consensus can be removed or deactivated with the approval of the IESG, or at the request of the original registrant, in consultation with or at the request of the designated experts.¶
On receipt of a registration request, IANA will initiate review by the designated expert(s), who will evaluate the request using the criteria in Section 2.1.1 in consultation with the current working group mailing list focused on the development of EPP extensions, if such a working group exists.¶
When submitting changes to existing registry entries, include text in the "Notes" field of the registration form describing the change. Under normal circumstances, registry entries are only to be updated by the registrant. If the registrant becomes unavailable or is otherwise unresponsive, a designated expert can submit a registration form to IANA to update the registrant information. Entries can change state from "Active" to "Inactive" and back again as long as state-change requests conform to the processing requirements identified in this document. In addition to entries that become "Inactive" due to a lack of implementation, entries for which a specification becomes consistently unavailable over time should be marked "Inactive" by the designated expert until the specification again becomes reliably available.¶
Section 2 provides IANA registration considerations. These considerations are not repeated here.¶
IANA has created the "Extensions for the Extensible Provisioning Protocol (EPP)" registry [IANA-REG] to manage EPP extensions, described in Section 2. In the registry, IANA has replaced the reference to [RFC7451] with a reference to this RFC and added a note to explain that the early allocation policy defined in [RFC7120] does not apply. IANA has also changed the "Document Status" of all non-RFC documents from "Informational" to "Other".¶
This document introduces no new security considerations to EPP. However, extensions should be evaluated according to the Security Considerations of [RFC3735] (or its future replacement) and [STD69].¶
The updates defined in this document are meant to enhance the guidance for reviewing EPP extensions (e.g., avoid non-IETF specifications squatting on IETF XML namespaces) and thus allow for better interoperability.¶
Section 2 includes provisions for modifying and deleting existing registration entries by registrants. Such requests may have operational implications on other entities that deploy those extensions. Note that the registry does not include a history mechanism and there is no way to track deleted entries once they have been removed.¶
Section 3 updates the content of "Document Status" to be compliant with the guidance in Section 2. The update does not impact the extension itself or induce any operational issues.¶
The information described in the registry is based on a suggestion posted to the provreg mailing list by Jay Daley in August 2013. The need to update [RFC7451] was first proposed by Gavin Brown. Additional feedback for the update was provided by the following people: Gavin Brown, James Galvin, James Gould, Pawel Kowalik, Andrew Newton, and Jasdip Singh.¶