Skip to main content
Feature flags are boolean values stored per jurisdiction that control which features are active on the platform. Because each jurisdiction may have different requirements, feature flags allow a single deployment to serve multiple jurisdictions with different capabilities enabled. Flags are stored as strings in the database and resolved at runtime. The canonical list of supported flags is defined in api/src/enums/feature-flags/feature-flags-enum.ts.

Managing feature flags

Admin users can toggle feature flags for their jurisdiction through the Partners Portal:
  1. Log in to the Partners Portal as a jurisdictional admin or support admin.
  2. Navigate to the Settings tab. This tab is only visible when the enablePartnerSettings flag is already enabled for that jurisdiction.
  3. Find the flag you want to change and toggle it on or off.
  4. Changes take effect immediately without a deployment.
The enablePartnerSettings flag must be enabled before the Settings tab is accessible. This flag is typically enabled by a support admin during initial jurisdiction setup.

Flag reference

All supported feature flags are listed below, grouped by the area of the platform they affect.
FlagDescription
enableAccessibilityFeaturesWhen true, the accessibility features section is displayed in listing creation/edit and the public listing view
enableNeighborhoodAmenitiesWhen true, the neighborhood amenities section is displayed in listing creation/edit and the public listing view
enableNeighborhoodAmenitiesDropdownWhen true, neighborhood amenities inputs render as dropdowns with distance options instead of textareas
enableMarketingStatusWhen true, the marketing status sub-section is displayed in listing creation/edit and the public listing view
enableMarketingStatusMonthsWhen true, the marketing status sub-section uses months instead of seasons. Requires enableMarketingStatus to also be true
enableMarketingFlyerWhen true, the marketing flyer sub-section is displayed in listing creation/edit and the public listing view
enableHomeTypeWhen true, the home type feature is turned on
enableListingFilteringWhen true, a filter button is shown on the listings browse page and users can filter using options in the drawer
enableListingPaginationWhen true, the listings browser displays pagination controls
enableListingOpportunityWhen true, any newly published listing sends a GovDelivery email to everyone signed up for listing alerts
enableListingFavoritingWhen true, a Favorite button is shown for public listings and users can view their favorited listings
enableListingFileNumberWhen true, partners can enter and export a listing file number
enableListingUpdatedAtWhen true, the listing detail page displays an updated-at date
enableListingImageAltTextWhen true, partners can add alt text to listing images
enableLeasingAgentAltTextWhen true, alternative text is shown for leasing agent users
enableIsVerifiedWhen true, the listing contents can be manually verified by a user
enableNonRegulatedListingsWhen true, non-regulated listings are displayed in listing creation/edit and the public listing view
enablePropertiesWhen true, the properties feature is enabled
enableUnitGroupsWhen true, unit groups are used instead of individual units
enableUtilitiesIncludedWhen true, the utilities included section is displayed in listing creation/edit and the public listing view
enableSection8QuestionWhen true, Section 8 listing data is visible
enableWhatToExpectAdditionalFieldWhen true, the what to expect additional field is displayed in listing creation/edit on the Partners Portal
disableBuildingSelectionCriteriaWhen true, building selection criteria is not displayed in the listing
disableListingPreferencesWhen true, listings no longer support a preferences section
hideCloseListingButtonWhen true, the close button is hidden on the listing edit form
enableWaitlistAdditionalFieldsWhen true, additional waitlist fields are displayed in the waitlist section of the listing form
swapCommunityTypeWithProgramsWhen true, the programs section on the frontend is displayed as community types
enableV2MSQWhen true, the new multiselect question logic is used
FlagDescription
disableCommonApplicationWhen true, the digital common application is not an option for listings
enableVerifyIncomeWhen true, the income question on the application is validated against the listing’s income limits and an error is shown if income is outside limits
enableFullTimeStudentQuestionWhen true, the full time student question is displayed in the application form
disableWorkInRegionWhen true, the Work in Region question is removed from the application process
enableSpokenLanguageWhen true, the application demographics section displays a spoken language question with options configured on the jurisdiction
disableEthnicityQuestionWhen true, the ethnicity question is hidden in the application demographics section
enableLimitedHowDidYouHearWhen true, the Radio Ad and Bus Ad options are removed from the how did you hear section
enableAdaOtherOptionWhen true, the ADA impairment options include a For Other Impairments option
enableWaitlistAdditionalFieldsWhen true, the waitlist additional fields are displayed in the waitlist section of the listing form
enableWhatToExpectAdditionalFieldWhen true, the what to expect additional field is displayed in listing creation/edit on the Partners Portal
enableReferralQuestionUnitsWhen true, the referral details question labels are updated
enableApplicationStatusWhen true, the application status and notifications feature is enabled on the public and Partners sites
FlagDescription
enableWaitlistLotteryWhen true, the jurisdiction supports lotteries for waitlist opportunities
FlagDescription
enableSingleUseCodeWhen true, the backend allows logging into this jurisdiction using the single-use code (passwordless) flow
enableSupportAdminWhen true, support admin users can be created
disableJurisdictionalAdminWhen true, jurisdictional admins cannot be created
enableHousingAdvocateWhen true, partners can view housing advocate users
FlagDescription
enablePartnerSettingsWhen true, the Settings tab is visible in the Partners Portal
enablePartnerDemographicsWhen true, demographics data is included in application or lottery exports for partners
enableCompanyWebsiteWhen true, partners can add company website information
enableHousingDeveloperOwnerWhen true, the Housing developer field label becomes Housing developer / owner
FlagDescription
enableGeocodingPreferencesWhen true, preferences can be created with geocoding functionality and applications on geocoded listings are geocoded on create/update
enableGeocodingRadiusMethodWhen true, geocoding preferences can verify applicant addresses via a mile radius
enableRegionsWhen true, a region can be defined for the building address
enableConfigurableRegionsWhen true, configurable regions per jurisdiction are enabled on the Partners and Public sites
FlagDescription
enableAdditionalResourcesWhen true, a learn more section is displayed on the home page
enableFaqWhen true, a link to the FAQ page is displayed on the get assistance page
enableResourcesWhen true, the public site displays links to resources on various pages
enableUnderConstructionHomeWhen true, the under construction section is displayed on the home page
enableHousingBasicsWhen true, a link to the housing basics page is displayed on the get assistance page
enableParkingFeeWhen true, the parking fee field is visible in the listing form
enableParkingTypeWhen true, the parking type field is visible in the listing form
enableCreditScreeningFeeWhen true, the credit screening fee field is enabled for listings
enablePetPolicyCheckboxWhen true, the pet policy field in the listing form is displayed as checkboxes instead of a text area
enableSmokingPolicyRadioWhen true, the listing Smoking policy field is a radio group
enableUnitAccessibilityTypeTagsWhen true, unit accessibility type tags (for example, Mobility units) are displayed on listing cards and details
disableAccessibilityFeaturesTagWhen true, the listing accessibility features tag is hidden on public listing cards and details

Build docs developers (and LLMs) love