Skip to content

Troubleshooting ​

Most of the time Fablnx doesn't fail — it waits. A tool is greyed out because something has to happen first, and the tooltip says what. This page collects every one of those, plus the refusals and messages you can hit while working.

Read the tooltip first

Every disabled control in Fablnx carries its own reason. Hover it and it tells you exactly what it's waiting for — the tables below are the same answers, gathered in one place.

"Why is this tool greyed out?" ​

The scene editor unlocks progressively. You set the grid up first, give it a scale, then place steel onto it — so you build in the order the drawing can actually support. Here is the whole chain.

The drawing tools (the left rail) ​

ToolGreyed out whenTooltip you'll seeFix
Dimension / Calibrate KThe scene has no grid linesDraw grid lines firstUse Grid line G, or run Detect grid lines
Column C (plan)No dimension recorded yetAdd a dimension (Calibrate) firstRecord one bay with Dimension K
Member M (elevation)No level line pinned yetPin a level first (Level tool, L)Use Level line L and click a horizontal
Beam B / Brace XNo columns placedPlace columns firstPlace or detect columns
Beam B / Brace XSome column has no profileGive every column a profile firstGive each column a section — or run Match profiles with Columns ticked

The tooltip on screen is the tool's own label with the reason appended, e.g. Dimension — two grid lines + a distance — Draw grid lines first. The column above quotes the reason half.

Why beams wait for column profiles

A beam frames into columns. Until every column knows its section, the model can't say where the beam actually stops — so the sequence is deliberate rather than a limitation. It also means Match profiles (with Columns ticked) is worth running before you start drawing beams by hand.

The AI detect steps ​

Same chain, worded for the detectors:

StepGreyed out whenTooltip you'll see
Detect grid linesThe scene isn't on a sheet regionDetect grid lines — place this scene on a sheet region first
CalibrateNo grid yetCalibrate — detect the grid first
Detect columnsNot calibratedDetect columns — calibrate first
Match profilesNo columns, beams or braces yetMatch profiles — detect columns, beams or braces first
Detect beamsNo columns found yetDetect beams — detect columns first
Fill from the modelSee the next tableFill from the model — …

On an elevation only three of these exist: Detect grid lines & levels, Calibrate, and Fill from the model. The column and beam detectors read plans, so they aren't offered.

Fill from the model ​

Prefill needs two things: somewhere to put what it brings, and steel standing in Tekla to learn from.

Greyed out whenReason shown
Tekla isn't connectedConnect to Tekla first
A plan with no level setGive this scene a level first
A plan, and no steel in the model at or below its levelTekla holds nothing at or below this level to inherit from
An elevation, and an empty modelPush a sheet into Tekla first
The scene can't hold a member yetThe same reason the Column / Member tool is showing
It reads Tekla, not your other sheets

Prefill used to read the project's other drawings too, so tracing a sheet was enough to unlock it. It reads the model now: another drawing is a reading of a drawing, and the building is what's standing in Tekla. So a job with nothing pushed prefills nothing — push a plan first — and a section you corrected by hand in Tekla is the one the next sheet inherits.

Why a plan only inherits from at-or-below

Column sections are scheduled on the lower plan, and a column comes up from the level beneath. Steel above yours has nothing to teach this one. Each intersection finds its own level below, too — so a split level (ROOF FRAMING PLAN – AREA B) inherits from what stands under Area B, not from Area A just because Area A happens to sit higher.

Other disabled controls ​

ControlWaiting forTooltip
Create in the New scene dialogA name — and, for a plan, a level—
Add level in the Structure panelA non-blank name and an elevation that reads as feet and inches—
Push to Tekla on a sceneA validation pass that came back cleanPush to Tekla — validate clean first
Runs along (elevation inspector)This sheet's own gridDraw or detect a grid line on this sheet first.
Fill slope (plans only)Two pinned, parallel lines that both have an elevation, and at least one unpinned parallel line left to fillThe reason appears as a hint under the button: Pin two lines to define the slope. / Set the Cut level, or give the pinned lines an elevation. / Pinned lines must be parallel — a slope runs one way. / Two pins sit on the same line.

Fill slope is a plan tool

There is no Fill slope on an elevation. A sloped datum on an elevation is a slant line instead — see Tracing an elevation.

The prefill tooltip lowercases its reason

Fill from the model builds its tooltip by lowercasing whatever is blocking it, so you'll see things like Fill from the model — pin a level first (level tool, l). That trailing l is the key L.


Controls that don't do what they say ​

A few labels in the app currently promise more than the build delivers. These are known, and listed here so you don't lose time on them.

WhereWhat it saysWhat actually happens
Scene editor, a level or slant lineRight-click → DeleteReads Delete grid undefined and does nothing. Delete it from the inspector instead
Scene editor, a level lineLeft-click with SelectDoes not open its properties panel
Scene editor status barThe levels countCounts the project's levels, not the ones pinned on this sheet
3D model status barM move · Del delete · Ctrl+Z undoThe 3D model is read-only. Edit members in their source scene, then revalidate and commit
3D model status barThe clash countNever appears — clash reporting is not currently wired
Copilot panelThe Ask the copilot composerDisabled — the app labels it coming soon

"It refused to let me do that" ​

These are deliberate refusals, not bugs. Each one is protecting a rule the model depends on.

"A column is vertical" ​

You tried to draw a column between two different grid lines on an elevation. A diagonal between two lines is a brace, not a column. Use the brace answer when the editor asks.

"That describes something vertical" ​

You tried to put both work points of a slant line on the same grid line. A slope has to run between two lines; something vertical is a column.

A grid intersection already has a column ​

One column per intersection. Click one that's occupied and Fablnx tells you rather than stacking a second on top. Dragging a run across several intersections simply skips the occupied ones.

If validation later reports "4 columns stand at CO-8 × CO-M — a station takes one", that's a stack a detector or a prefill created, not something you could click. Delete all but the right one — and note you may be looking at the one on top while the problem is underneath it.

A slope won't delete ​

A beam runs along it. A rafter can't disappear out from under the framing that follows it. Move or delete those beams first.

Steel that merely sits at a height the slope passes through isn't carried by it and doesn't block the delete.

Prefill stopped and wrote nothing ​

Your elevation names several grid lines — ELEVATION ALONG GRIDS B, C, D, F, G, H & I — which asserts those frames are identical, and the committed building disagrees. Fablnx tells you exactly where: which member, at which grid and height, which of your grids have it and which don't.

Nothing is written on purpose: a half-filled elevation looks traced while quietly missing steel on some frames. Either narrow this scene's grid lines to the ones that genuinely match, or split the scene in two, then prefill again.

An elevation won't commit ​

An elevation that names no grid line fails validation with elevation_no_grid, so Push to Tekla stays disabled with its usual Push to Tekla — validate clean first tooltip. Set Runs along in the inspector — see Tracing an elevation.


"Where did my steel go?" ​

A member vanished after I deleted a level line ​

It's still there. Steel records its height, not the rule you read the height off — so removing a horizontal never costs you work. The member simply stops being drawn until something on the sheet states that height again. The member table still lists it.

Pin a level back at that height, or place an offset elevation there, and it reappears.

I redrew a rafter and the framing didn't follow ​

Same rule. A beam framed to a slope is recorded at that elevation, not attached to the slope. Redraw the rafter and the beam stays where you put it — so check the framing after you change a slope.

The 3D model is missing members I definitely drew ​

Look at World in the Structure panel. Anything the model can't place is listed by name with the reason — an undimensioned grid line, a member with no locatable anchor, a column drawn on only one plan. That list is a to-do, not an error log.

Also check the scene is actually committed: the world is the set of committed scenes.

My scene dropped out of the model on its own ​

You edited it. Editing a committed scene takes it back out of the world until you validate and commit again, so a sheet in the model is always exactly what it says on screen. The in-world badge clears on your first accepted edit.

That holds however the edit arrives — your own change, the same project open in another window, or a detection step writing to the sheet. There is no warning dialog; the badge clearing is the only signal.


Detection didn't find everything ​

This is expected, and the shape of what it misses is predictable.

What happenedWhyWhat to do
A beam framing into the middle of a girder wasn't foundEvery detected member is anchored to grid intersections; that beam has no crossing at its far endDraw it yourself
Detection found detail ink as a columnDetect columns deliberately errs toward showing you too much, including shapes that appear onceUse Review detections and delete what doesn't belong
Columns have no section on an upper planThe sheet genuinely never states one — sections are scheduled on the lower planFill from the model
Nothing detects on an elevation except grid and calibrateThe column and beam detectors read plans; pointing one at an elevation would write plan-shaped rowsTrace it, or Fill from the model
A sheet shows no suggested regionsA very dense sheet — typically a scan traced back to vectors — can be too heavy to segmentOutline the region by hand

Precision over recall

Fablnx is tuned to raise fewer false positives rather than catch absolutely everything. Reviewing and deleting a handful of extras is quick; finding steel that was silently invented is not.


Reading a schedule off the sheet didn't work ​

Boxing a schedule with a rectangle markup and clicking Read from a markup returns a proposal, never rows — so "didn't work" is usually the proposal saying something you can fix before adding it. See Read a schedule off the sheet.

What you seeWhyWhat to do
Box the schedule on a sheet with a rectangle markup firstThe markup you picked is a pin, which has no area to readDraw a rectangle around the schedule
No text inside that markupThe sheet is a scan — a picture with no text layer, and Fablnx does not OCRUse a vector PDF of the sheet, or enter the marks by hand
Rows come back but the box covers only part of the scheduleThe reader only sees what is inside the rectangleRedraw the markup around the whole schedule, including its level rules and its locations row
A column's location cell is blank, showing no grid reference readThe cell said something neither the reader nor the model could read as a grid intersectionType it in — the row is otherwise complete and can still be ticked
A piece says top is not on a levelThe drawn line stops at a height no level on the sheet names, which is true of a post that stops where its wall doesName the level yourself, or leave the piece out
A piece says 2 sections written on this pieceTwo sections straddle the line with nothing saying where it changesSplit it by hand, or pick the one that applies
A row has a coloured rule down its left edgeIt was read by a language model because the drawing's own text did not parse, so nothing on the sheet vouches for itCheck it against the sheet, then tick it

Nothing is saved until you click Add

Reading writes nothing. Every row is editable in place and only the ticked ones are added, so a proposal that came back half-right costs you the half you keep.


Validation questions I can't get rid of ​

There is no way to dismiss an RFI, by design. A finding answers itself the moment the underlying problem is gone, and reopens by itself if it comes back. An open question always blocks Push to Tekla, so what reaches the model is genuinely coordinated rather than waved through.

If a finding looks wrong:

  • Click the row. It opens the scene and lights up exactly what it's about. A cross-sheet conflict names the grid line on both sheets, and you'll see the one in front of you.
  • Check you're looking at the right member. Stacked columns are the classic case.
  • Remember you can always revise your own sheet freely. You're only blocked when your sheet disagrees with what another committed sheet says.
Two things validation deliberately does NOT flag

A member the plan shows and the elevation doesn't. Leaving things off for clarity is normal draughting — real sheets say so in the title block, "STEEL ACCESS NOT SHOWN FOR CLARITY". Since nothing can be dismissed, a rule that fired on correct drawings would make commit unreachable.

A column on two levels with different sections. That's a splice — a correct, buildable drawing. Only two sheets disagreeing at the same level is a conflict.


Nothing is loading ​

  • Check the connection. Fablnx is offline-aware and will tell you when it can't reach the server rather than leaving you guessing.
  • You don't need to refresh. Every panel updates itself as work lands — there is no Refresh button anywhere in Fablnx, and its absence is deliberate. If a panel looks stale, it is far more likely waiting on a step you haven't run.
  • One exception: the projects screen. It refreshes when the window regains focus rather than pushing live. Click away and back rather than reloading. See Projects & uploads.
  • A save is in flight. Every edit saves automatically; a brief spinner appears while one is going out. There's nothing to click.

Still stuck? ​

  • Look the word up in the Glossary — a surprising number of confusions are vocabulary.
  • Replay the guided tutorial from the help menu (?) in the top-right corner.
  • Walk Your first model end to end on the worked example.

Fablnx — the AI copilot for structural steel design & detailing. · Version: Unreleased