Registration Allowed

How the registration allowed subnet hyperparameter controls whether new neurons can register on a subnet.

Registration allowed is a per-subnet hyperparameter, listed in the documentation as NetworkRegistrationAllowed, that controls whether neuron registration is enabled on a subnet. When it is on, new neurons can register on that subnet; when it is off, the subnet does not accept new registrations.

References: Subnet Hyperparameters

What It Controls

The hyperparameter acts as a switch over registration for a subnet. It does not change how registration works or what it costs; it only sets whether registration is currently open. With the switch off, attempts to register on that subnet are not accepted until it is turned back on.

Reference: Subnet Hyperparameters

Default and Setting

The documentation lists a default of enabled and marks the parameter as set at the root level rather than by the subnet owner. Whether registration is open on a given subnet is per-subnet chain state and can differ from the default, so the live setting should be read for that subnet.

Reference: Subnet Hyperparameters

Subnet Context

Registration allowed is one of the subnet hyperparameters, the on-chain state variables that configure a single subnet, for example netuid 1. Because each subnet carries its own hyperparameters, the registration switch is defined per subnet and applies only within that subnet.

Reference: Subnet Hyperparameters

Relationship to Registration

Registration is how a neuron claims a place on a subnet. This hyperparameter sits one level above that process: it decides whether registration is available at all on the subnet right now. The two are connected because the switch gates the action, while the registration process and its cost describe how the action runs when it is permitted.

References: Subnet Hyperparameters, Register

Development Stage Context

The Introduction to Bittensor describes subnet development as moving from localnet to testnet and then mainnet. For registration allowed, that sequence changes how readers should interpret subnet entry-switch examples.

In localnet, registration switches can be tested in an isolated environment. Localnet registration availability does not represent production subnet entry policy.

On testnet, registration gating can be exercised in a shared non-production network. Testnet switch states are separate from mainnet subnet state.

On mainnet, registration allowed is a live per-subnet hyperparameter on production subnets. Whether new registration is open depends on the selected subnet’s on-chain hyperparameter state (Subnet Hyperparameters).

The Bittensor Networks reference separates mainnet, testnet, and localnet. A registration-allowed example from one environment should not be read as representing production entry policy in another environment.

Reader Boundary

This page defines the concept at a high level. It does not report whether registration is currently open on any particular subnet. That is live chain state and should be checked for the relevant netuid. The documented default is enabled, and the parameter is governed at the root level.

Reference: Subnet Hyperparameters

Open Registration Still Requires a Registration Burn

When registration is allowed on a subnet such as netuid 1, the Glossary: Register still describes subnet entry as purchasing a UID slot through a dynamic registration burn in TAO. The switch opens or closes registration; it does not remove the burn cost when entry is permitted.

Static articles should therefore describe registration as a gated action with a dynamic TAO price, not as a free slot assignment (Mining: Miner registration).

A Full Subnet Still Uses Displacement Rules

Registration allowed does not remove UID capacity limits. The Subnet Hyperparameters reference includes max_allowed_uids as the ceiling for a subnet, and mining documentation describes displacement when a full subnet admits a new registrant (Mining: Miner deregistration).

The registration switch and the slot ceiling answer different questions. Registration allowed names whether new entry is open; capacity and displacement rules name what happens when a full subnet still receives a registration attempt (Glossary: UID Slot).

The Switch Does Not Change Subnet Hyperparameters

Registration allowed is one root-level hyperparameter among many subnet settings. Turning it off stops new registrations on that subnet, but it does not by itself change other values such as tempo, activity cutoff, or maximum UID count.

Readers should treat the switch as a gate on the registration action rather than as a general subnet pause control. Live hyperparameter values for a subnet belong in current chain state and official subnet hyperparameter references (Subnet Hyperparameters).

Further Reading

Topics SubnetsRegistration