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 inDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/bloom-housing/bloom/llms.txt
Use this file to discover all available pages before exploring further.
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:- Log in to the Partners Portal as a jurisdictional admin or support admin.
- Navigate to the Settings tab. This tab is only visible when the
enablePartnerSettingsflag is already enabled for that jurisdiction. - Find the flag you want to change and toggle it on or off.
- 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.Listings
Listings
| Flag | Description |
|---|---|
enableAccessibilityFeatures | When true, the accessibility features section is displayed in listing creation/edit and the public listing view |
enableNeighborhoodAmenities | When true, the neighborhood amenities section is displayed in listing creation/edit and the public listing view |
enableNeighborhoodAmenitiesDropdown | When true, neighborhood amenities inputs render as dropdowns with distance options instead of textareas |
enableMarketingStatus | When true, the marketing status sub-section is displayed in listing creation/edit and the public listing view |
enableMarketingStatusMonths | When true, the marketing status sub-section uses months instead of seasons. Requires enableMarketingStatus to also be true |
enableMarketingFlyer | When true, the marketing flyer sub-section is displayed in listing creation/edit and the public listing view |
enableHomeType | When true, the home type feature is turned on |
enableListingFiltering | When true, a filter button is shown on the listings browse page and users can filter using options in the drawer |
enableListingPagination | When true, the listings browser displays pagination controls |
enableListingOpportunity | When true, any newly published listing sends a GovDelivery email to everyone signed up for listing alerts |
enableListingFavoriting | When true, a Favorite button is shown for public listings and users can view their favorited listings |
enableListingFileNumber | When true, partners can enter and export a listing file number |
enableListingUpdatedAt | When true, the listing detail page displays an updated-at date |
enableListingImageAltText | When true, partners can add alt text to listing images |
enableLeasingAgentAltText | When true, alternative text is shown for leasing agent users |
enableIsVerified | When true, the listing contents can be manually verified by a user |
enableNonRegulatedListings | When true, non-regulated listings are displayed in listing creation/edit and the public listing view |
enableProperties | When true, the properties feature is enabled |
enableUnitGroups | When true, unit groups are used instead of individual units |
enableUtilitiesIncluded | When true, the utilities included section is displayed in listing creation/edit and the public listing view |
enableSection8Question | When true, Section 8 listing data is visible |
enableWhatToExpectAdditionalField | When true, the what to expect additional field is displayed in listing creation/edit on the Partners Portal |
disableBuildingSelectionCriteria | When true, building selection criteria is not displayed in the listing |
disableListingPreferences | When true, listings no longer support a preferences section |
hideCloseListingButton | When true, the close button is hidden on the listing edit form |
enableWaitlistAdditionalFields | When true, additional waitlist fields are displayed in the waitlist section of the listing form |
swapCommunityTypeWithPrograms | When true, the programs section on the frontend is displayed as community types |
enableV2MSQ | When true, the new multiselect question logic is used |
Applications
Applications
| Flag | Description |
|---|---|
disableCommonApplication | When true, the digital common application is not an option for listings |
enableVerifyIncome | When 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 |
enableFullTimeStudentQuestion | When true, the full time student question is displayed in the application form |
disableWorkInRegion | When true, the Work in Region question is removed from the application process |
enableSpokenLanguage | When true, the application demographics section displays a spoken language question with options configured on the jurisdiction |
disableEthnicityQuestion | When true, the ethnicity question is hidden in the application demographics section |
enableLimitedHowDidYouHear | When true, the Radio Ad and Bus Ad options are removed from the how did you hear section |
enableAdaOtherOption | When true, the ADA impairment options include a For Other Impairments option |
enableWaitlistAdditionalFields | When true, the waitlist additional fields are displayed in the waitlist section of the listing form |
enableWhatToExpectAdditionalField | When true, the what to expect additional field is displayed in listing creation/edit on the Partners Portal |
enableReferralQuestionUnits | When true, the referral details question labels are updated |
enableApplicationStatus | When true, the application status and notifications feature is enabled on the public and Partners sites |
Lottery
Lottery
| Flag | Description |
|---|---|
enableWaitlistLottery | When true, the jurisdiction supports lotteries for waitlist opportunities |
User and authentication
User and authentication
| Flag | Description |
|---|---|
enableSingleUseCode | When true, the backend allows logging into this jurisdiction using the single-use code (passwordless) flow |
enableSupportAdmin | When true, support admin users can be created |
disableJurisdictionalAdmin | When true, jurisdictional admins cannot be created |
enableHousingAdvocate | When true, partners can view housing advocate users |
Partners Portal
Partners Portal
| Flag | Description |
|---|---|
enablePartnerSettings | When true, the Settings tab is visible in the Partners Portal |
enablePartnerDemographics | When true, demographics data is included in application or lottery exports for partners |
enableCompanyWebsite | When true, partners can add company website information |
enableHousingDeveloperOwner | When true, the Housing developer field label becomes Housing developer / owner |
Map and geocoding
Map and geocoding
| Flag | Description |
|---|---|
enableGeocodingPreferences | When true, preferences can be created with geocoding functionality and applications on geocoded listings are geocoded on create/update |
enableGeocodingRadiusMethod | When true, geocoding preferences can verify applicant addresses via a mile radius |
enableRegions | When true, a region can be defined for the building address |
enableConfigurableRegions | When true, configurable regions per jurisdiction are enabled on the Partners and Public sites |
UI and display
UI and display
| Flag | Description |
|---|---|
enableAdditionalResources | When true, a learn more section is displayed on the home page |
enableFaq | When true, a link to the FAQ page is displayed on the get assistance page |
enableResources | When true, the public site displays links to resources on various pages |
enableUnderConstructionHome | When true, the under construction section is displayed on the home page |
enableHousingBasics | When true, a link to the housing basics page is displayed on the get assistance page |
enableParkingFee | When true, the parking fee field is visible in the listing form |
enableParkingType | When true, the parking type field is visible in the listing form |
enableCreditScreeningFee | When true, the credit screening fee field is enabled for listings |
enablePetPolicyCheckbox | When true, the pet policy field in the listing form is displayed as checkboxes instead of a text area |
enableSmokingPolicyRadio | When true, the listing Smoking policy field is a radio group |
enableUnitAccessibilityTypeTags | When true, unit accessibility type tags (for example, Mobility units) are displayed on listing cards and details |
disableAccessibilityFeaturesTag | When true, the listing accessibility features tag is hidden on public listing cards and details |