Job Model Overrides
Job Model Overrides let an individual unit (Job) differ from its assigned Job Model for a limited set of numeric / area attributes, and optionally its floor plan file. Overrides are strictly opt‑in: the platform always uses the Job Model unless a meaningful difference is supplied.
Which Fields Can Be Overridden
The override scope is intentionally narrow. You can adjust only the permanent physical dimension and area values below. Names are shown here in a readable format (the underlying system uses internal field identifiers):
Core Dimensions
- Bedrooms
- Bathrooms
- Width (Feet)
Area Components
- Upper Deck Square Feet
- Rear Deck Square Feet
- Patio Square Feet
- Porch Square Feet
- Other Deck Square Feet
- Garage Square Feet
Floor plan file override is separate: a unit can supply a distinct floor plan PDF/image that replaces the model’s shared floor plan everywhere it is displayed or merged.
Entering Override Mode (Workbench)
In the Apartment Units screen there is a toggle (Override Mode) that switches the units table into an "Overrides" view. In this view each field you can change shows:
- A small status icon indicating whether the unit currently matches the base model.
- A number you can edit (where allowed).
What the icon means:
- Green check: The unit still matches the base model value (no effective override).
- Orange marker: The value has been changed for this unit.
- Blank: No value (or not applicable).
When you save, only the meaningful differences are recorded. If you change a value and later put it back to the model’s original number, it is treated as if no override exists.
Identical values are not treated as real overrides. Change only what physically differs from the base model.
Floor Plan Override
Each unit automatically shows the floor plan that belongs to its base model. If the physical unit needs a different floor plan file, you can upload one specifically for that unit. Once a unit‑specific floor plan is present, it is used everywhere the floor plan is displayed (previews, documents, portals). Removing the unit’s custom file immediately reverts the unit to the shared model floor plan—no extra steps required.
How Overrides Appear Elsewhere
Once saved, overridden numbers appear everywhere you normally see unit information (panels, summaries, generated documents). You do not need to take any extra action—totals and derived figures (such as total square footage) automatically reflect the updated values. Only the Overrides view shows both the current unit value and the original model value side by side.
When to Use Overrides
Use overrides for permanent, physical divergences (e.g., widened garage, deck size adjustment). Do not use for temporary marketing variations or sales options—handle those through options or change orders.
Troubleshooting
| Issue | Likely Reason | What to Do |
|---|---|---|
| No orange override icon after editing | The value still matches the model | Enter the actual differing value you intend to record |
| Custom floor plan not appearing | The uploaded file is identical to the model’s file or upload not completed | Upload the correct file and confirm it finishes processing |
| Floor plan viewer says none available | Neither a model floor plan nor a unit floor plan exists yet | Add the model floor plan first, or upload a unit‑specific one |
| Total square footage looks wrong | One or more area components were changed | Review each area value in Override Mode and confirm accuracy |
Summary
Overrides let you fine‑tune a unit only when it physically differs from the base model. Change a value only if the built (or to‑be‑built) unit truly deviates. Keep the base model accurate; keep overrides rare. A unit floor plan file you upload replaces the model’s version until you remove it.