Skip to main content
UpdatedThe diagnoses block in ambientOptions is supported in the Web SDK v2.1.2. Pass the patient’s existing diagnoses (e.g. from the EMR) so the session merges them with what’s discussed in the visit. Refer to the Existing patient diagnoses guide for more details.
Problem-Based Charting (PBC) organizes clinical notes by patient problems instead of traditional note sections. To enable it in the Web SDK, mark one section as the Problem-Based Note (PBN) by setting isPBNSection: true on that section in ambientOptions (using the section’s LOINC code).

​
Implementation

JavaScript

​
Configuration rules

1

Single PBN Section

Only one section can have isPBNSection: true. If multiple sections are marked as PBN, the ambient session will fail to start.
2

Explicit Flag Values

Explicitly pass true or false for the isPBNSection flag. The value provided will be respected as-is.
3

Default Behavior

If no section includes the isPBNSection flag (i.e., left undefined) and the Assessment & Plan section (51847-2) is present, that section will automatically be treated as the PBN.
4

Override Default

If you explicitly set isPBNSection: false on the Assessment & Plan section, the automatic default behavior will not apply.
For a given ambient session, only one section can have isPBNSection: true. If more than one section is marked as PBN, the ambient session will fail to start.

​
Existing patient diagnoses

Pass the patient’s current diagnoses (e.g. from the EMR) into the session using the diagnoses block in the ambientOptions object. The SDK automatically merges them with what’s discussed during the visit so the note has one problem list and no duplicates. When you switch to a new patient or encounter, pass that encounter’s diagnoses in ambientOptions; see Update encounter and ambient options for more details.
Diagnoses can be seeded only at the start of the first session in an encounter.
In re-ambient (later sessions in the same encounter), you cannot seed diagnoses; rely on the note from the previous session for any updates. A diagnosis you pass in is included in the note only if the provider or patient talks about it during the visit. If they don’t mention it, it’s left out.

​
Requirements for passing diagnoses

  • You must have at least one PBC section in your ambientOptions.sections (set isPBNSection: true).
  • For each diagnosis you pass in:
    • Include exactly one code in the codes array.
    • Set the code type to "ICD10".
    • Provide at least one of code or description (you can provide both).
    • diagnosis_note is optional.
Things to keep in mind
  • Input: Only ICD10 is supported for the diagnoses you pass in. Output can include ICD10, IMO, and SNOMED.
  • AutoCoding: Off by default so your seeded data is used as is.
ResponseThe response is unchanged when you pass diagnoses. You receive the same object (noteId, encounterId, contents) via onNoteSubmit or note-submission:success.For the full response structure, refer to Note management - Response structure.

​
Next steps

Track session state: Ambient session status Multilingual sessions: Multilingual support Return to Ambient session overview
Last modified on July 23, 2026