Skip to main content

Overview

This page documents the various enumeration types used throughout the Digital Planning Data Schemas. Each enum provides a controlled vocabulary for specific domains within planning applications.

File Types

The FileTypes enum defines all document and drawing types that can be submitted with planning applications.

Type Definition

export type FileType = {
  value: FileTypeKeys;
  description: string;
};

type FileTypeKeys = keyof typeof FileTypes;

Common File Types

KeyDescription
locationPlanLocation plan
sitePlan.existingSite plan - existing
sitePlan.proposedSite plan - proposed
floorPlan.existingFloor plan - existing
floorPlan.proposedFloor plan - proposed
elevations.existingElevations - existing
elevations.proposedElevations - proposed
sections.existingSections - existing
sections.proposedSections - proposed
roofPlan.existingRoof plan - existing
roofPlan.proposedRoof plan - proposed
unitPlan.existingUnit plan - existing
unitPlan.proposedUnit plan - proposed
usePlan.existingUse plan - existing
usePlan.proposedUse plan - proposed
KeyDescription
designAndAccessStatementDesign and Access Statement
planningStatementPlanning statement
heritageStatementHeritage Statement
sustainabilityStatementSustainability statement
statementOfCommunityInvolvementStatement of community involvement
affordableHousingStatementAffordable housing statement
energyStatementEnergy statement
KeyDescription
floodRiskAssessmentFlood risk assessment (FRA)
environmentalImpactAssessmentEnvironmental Impact Assessment (EIA)
transportAssessmentTransport assessment
noiseAssessmentNoise assessment
lightingAssessmentLighting assessment
landscapeAndVisualImpactAssessmentLandscape and visual impact assessment (LVIA)
contaminationReportContamination report
foulDrainageAssessmentFoul drainage assessment
townCentreImpactAssessmentTown centre uses - Impact assessment
townCentreSequentialAssessmentTown centre uses - Sequential assessment
KeyDescription
arboriculturistReportArboriculturist report
treesReportTrees report
treeSurveyTree survey
treeConditionReportTree condition report
treeAndHedgeLocationLocation of trees and hedges
treeAndHedgeRemovedOrPrunedRemoved or pruned trees and hedges
treeCanopyCalculatorTree canopy calculator
ecologyReportEcology report
biodiversityNetGainInformationBiodiversity Net Gain (BNG) information
KeyDescription
photographs.existingPhotographs - existing
photographs.proposedPhotographs - proposed
visualisationsVisualisations
streetSceneStreet scene drawing
sketchPlanSketch plan
technicalEvidenceTechnical evidence
methodStatementMethod statement
statutoryDeclarationStatutory declaration

Project Types

The ProjectTypes enum defines the types of development work being proposed.

Type Definition

export type ProjectType = {
  value: ProjectTypeKeys;
  description: string;
};

type ProjectTypeKeys = keyof typeof ProjectTypes;

Major Categories

Major category for modifying existing structures:
  • alter - Alter a building
  • alter.boundary - Changes to a fence, wall or gate
  • alter.equipment - Install equipment
  • alter.equipment.solar - Install solar panels
  • alter.equipment.heatPump - Install a heat pump
  • alter.openings - Change a door or window opening
  • alter.roof - Change the roof
  • alter.surfaces - Add a decked area or patio
  • alter.trees - Changes to trees or hedges
Plus 200+ specific alteration types.
Major category for adding to existing structures:
  • extend - Extend a building or add an outbuilding
  • extend.rear - Add a rear or side extension (or conservatory)
  • extend.front - Add a front extension
  • extend.roof - Add a roof extension
  • extend.roof.dormer - Add a roof dormer
  • extend.outbuilding - Add an outbuilding
  • extend.basement - Add a basement extension
  • extend.porch - Add a porch
Major category for changing how a property is used:
  • changeOfUse - Change the use of a building
  • changeOfUse.garage - Convert a garage
  • changeOfUse.outbuilding - Convert an outbuilding
  • changeOfUse.whole - Convert or change the use of a whole building
  • changeOfUse.annexe - Convert part into a granny flat
  • changeOfUse.workFromHome - Work from home
Major category for removing structures:
  • demolish - Demolish a building or structure
  • demolish.full - Total demolition of a building
  • demolish.part - Demolish part of a building
  • demolish.outbuilding - Demolish an outbuilding
  • demolish.boundary - Demolish a fence, gate or boundary wall
Major category for new construction:
  • new - Add a new separate building or self-contained units
  • new.dwelling - New, self-contained dwelling
  • new.dwelling.house - New houses
  • new.dwelling.flat - New flats
  • new.industrial - New industrial premises
  • new.retail - New retail premises
  • new.office - New offices
Major category for internal modifications:
  • internal - Internal building works
  • internal.walls - Alter internal walls
  • internal.floors - Alter internal floors
  • internal.loft - Convert a loft
  • internal.mezzanine - Add a mezzanine floor
  • maintain - Maintenance of an existing structure
  • repair - Repairs
  • unit - Change of units
  • unit.subdivide - Convert a home into flats
  • unit.merge - Convert two or more properties into one
  • other - Other project type

Usage

Project types use dot notation for hierarchical organization. For example:
  • extend.roof.dormer.rear is more specific than
  • extend.roof.dormer which is more specific than
  • extend.roof which is more specific than
  • extend

Property Types

The PropertyTypes enum defines property classifications based on BLPU (Basic Land and Property Unit) codes.

Type Definition

export type PropertyType = {
  value: PropertyTypeKeys;
  description: string;
};

Major Categories

'residential' | 'residential.house' | 'residential.house.detached' |
'residential.house.semiDetached' | 'residential.house.terrace' |
'residential.flat' | 'residential.HMO' | 'residential.institution'
Standard residential property types including houses, flats, and institutions.

Residential Unit Types

Two variants exist for tracking residential units:

UK-wide Types

export type UKResidentialUnitType = {
  value: 'cluster' | 'flat' | 'house' | 'other' | 'sheltered' | 'studio';
  description: string;
};

Greater London Authority (GLA) Types

export type GLAResidentialUnitType = {
  value: 'cluster' | 'coLiving' | 'detached' | 'flat' | 'HMO' |
        'hostel' | 'LW' | 'other' | 'semiDetached' | 'student' |
        'studio' | 'terraced';
  description: string;
};
GLA types provide more granular classification for London-specific reporting.

Use Classes

The GLAUseClasses enum defines land use classifications tracked by the Greater London Authority.
export type GLAUseClass = {
  value: GLAUseClassKeys;
  description: string;
};

Use Class Values

KeyDescription
bTwoB2 - General industry
bEightB8 - Storage and distribution
cOneC1 - Hotels
cTwoC2 - Residential institutions
cTwoAC2a - Secure residential institutions
cThreeC3 - Dwellinghouses
cFourC4 - Houses in multiple occupation (HMOs)
eE - Commercial, business and service
fOneF1 - Learning and non-residential institutions
fTwoF2 - Local community uses
SGSui generis
unknownNot known

Result Flags

The Flags enum defines outcomes from planning policy checks.

Type Definition

export type ResultFlag = {
  value: FlagKeys;
  description: string;
};

Flag Categories

FlagDescription
Planning permission / ImmuneChanges may be beyond time limit for enforcement
Planning permission / Permission neededProposed changes may require planning permission
Planning permission / Prior approvalPrior Approval required
Planning permission / NoticeNotice to planning authority required
Planning permission / Permitted developmentMay fall within Permitted Development rules
Planning permission / Not developmentMay not meet legal definition of ‘development’
Planning permission / Missing informationKey information missing
FlagDescription
Works to listed buildings / Consent neededListed building consent required
Works to listed buildings / De minimisWorks are minor (de minimis)
Works to listed buildings / Not requiredConsent not required
Works to listed buildings / Missing informationInformation missing
FlagDescription
Works to trees & hedges / Consent neededConsent required
Works to trees & hedges / NoticeNotice required
Works to trees & hedges / Not requiredNot required
Works to trees & hedges / Missing informationInformation missing
FlagDescription
Demolition in a conservation area / Consent neededConsent required
Demolition in a conservation area / De minimisWorks are minor
Demolition in a conservation area / Not requiredNot required
Demolition in a conservation area / Missing informationInformation missing
  • Planning policy - Meets/fails policy, edge cases
  • Community Infrastructure Levy (CIL) - Liable, exempt, relief
  • Material change of use - Determination of material change

Post-Submission Application Enums

The following enums are specific to the PostSubmissionApplication schema for tracking applications through the back office system.

Application Status

Tracks the overall status of an application.
export type ApplicationStatus = 
  | 'returned'    // Invalid application returned to applicant
  | 'withdrawn'   // Withdrawn by applicant before decision
  | 'determined'  // Decision made (even if appeal pending)
  | 'undetermined'; // No decision yet (may be in validation/consultation)
ValueDescription
returnedApplication is invalid and has been returned
withdrawnApplication withdrawn by applicant anytime before decision
determinedApplication has a decision, even if appeal is pending
undeterminedApplication has no decision yet

Process Stage

Defines the stage of the planning application process.
export type ProcessStage = 
  | 'submission'      // Initial submission
  | 'validation'      // Validation by planning authority
  | 'consultation'    // Public consultation period
  | 'assessment'      // Officer assessment (regardless of decision status)
  | 'appeal'          // Appeal lodged
  | 'highCourtAppeal'; // High court appeal
StageDescription
submissionApplication has been submitted
validationBeing validated by planning authority
consultationPublic consultation period
assessmentUnder officer assessment
appealAppeal has been lodged
highCourtAppealHigh court appeal in progress

Assessment Decision

The planning officer or committee decision outcome.
export type AssessmentDecision = 'granted' | 'refused';
DecisionDescription
grantedApplication approved
refusedApplication rejected

Appeal Decision

Outcome of a planning appeal.
export type AppealDecision = 
  | 'allowed'        // Appeal granted
  | 'dismissed'      // Appeal rejected
  | 'splitDecision'  // Partial approval
  | 'withdrawn';     // Appeal withdrawn
DecisionDescription
allowedAppeal was successful
dismissedAppeal was rejected
splitDecisionPartial approval granted
withdrawnAppeal withdrawn by appellant

Comment Types

Distinguishes between public and specialist comments.
export type CommentType = 'specialist' | 'public';
TypeDescription
specialistComment from a statutory consultee or specialist
publicComment from a member of the public

Comment Sentiment

Public Comment Sentiment

export type PublicCommentSentiment = 'objection' | 'neutral' | 'supportive';
SentimentDescription
objectionObjects to the application
neutralNeutral or informational comment
supportiveSupports the application

Specialist Comment Sentiment

export type SpecialistCommentSentiment = 
  | 'approved'         // Specialist approves
  | 'amendmentsNeeded' // Amendments required
  | 'objected';        // Specialist objects
SentimentDescription
approvedSpecialist approves the application
amendmentsNeededAmendments needed before approval
objectedSpecialist objects to the application

Enforcement Breach Types

The BreachTypes enum defines types of planning breaches that can be reported.

Type Definition

export type BreachType = {
  value: BreachTypeKeys;
  description: string;
};

Breach Categories

KeyDescription
alterAlteration
alter.boundaryNew or modified boundary fence or wall
alter.equipment.antennaeMicrowave antennas or satellite dishes
alter.highwaysCreation of a new access (eg a dropped kerb)
alter.landscapeChange of land levels
alter.openingsWorks to windows or doors
alter.roofChanges to roof including skylights
alter.soilPipesChimney flue or soil and vent pipes
alter.surfaces.parkingCreation of driveway or laying of hardstanding
alter.swimmingPoolNew or modified swimming pool
KeyDescription
alter.treesWorks to trees
alter.trees.treeWorks to a dangerous or dead tree
alter.trees.tree.otherOther works to a tree
alter.trees.tree.pruneWorks to a healthy tree
alter.trees.tree.removeFelling of a tree
KeyDescription
extendExtension
extend.porchNew or modified porch
extend.roof.dormerInserting a dormer window
outbuildingNew or modified outbuilding (eg garage or shed)
KeyDescription
changeOfUseUnauthorised change of use
changeOfUse.caravansCaravan or mobile homes
listedWorks to a listed building
mineralsMinerals and waste development
planningConditionBreach of a planning condition
signageNew adverts or signage (including flags)
untidySiteUntidy land
otherOther type of planning breach

Build docs developers (and LLMs) love