Troubleshooting
Codex ribbon is missing
- Confirm you are running the targeted Revit 2025 build.
- Ask the maintainer to check the local registration and assembly paths while Revit is closed. Rebuilding removes development signatures; re-sign before restarting Revit where applicable.
- Never disable Revit security checks or change certificate trust to hide a warning. There is no production installer or signing identity yet.
Commands are disabled
Open a project document. Commands are unavailable in family documents or with no project open.
Input cannot be read
The first file must be a real DXF (AutoCAD 2000 or newer, not a renamed DWG); the second must be the mapping JSON. If you edited the JSON, check its syntax. Keep the original files and note the exact diagnostic.
No model-space entities
Put the detail in model space. Paper space, unused layers and nested block contents are not read.
Missing layers or target types
Compare exact names, including case. Recreate the mapping from the open project's styles; a mapping from another template may name absent types. Codex skips missing targets instead of substituting.
Nothing remains importable
Review unsupported kinds, unmapped layers, unavailable types, invalid boundaries and short geometry. No drafting view is created when every entity is rejected. A region mapping does not make a hatch or circle supported.
Text size differs
Check units and view scale, then the mapped type's paper size. Codex warns and uses the type unchanged. Review extents and anchoring; matching CAD font metrics is not promised.
Import fails or rolls back
Keep the diagnostic and reproduce only in a disposable project. Rollback is designed in but not yet verified in Revit, so check the document state before retrying. Never repeat failures in production files.
Reporting a problem safely
There is no public support portal or upload service. Through an approved private channel, share the Revit/build version, operation, expected result and diagnostic text, with paths, project names and firm identifiers removed. Prefer a wholly synthetic reproduction. Never post client drawings, RVTs, families, mappings, sensitive screenshots or credentials publicly.