> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Prepare global references

> Create GLOBAL references (globalReferenceNode) pinned to ONE SPECIFIC row. Use this when a document must reference MULTIPLE DIFFERENT rows of the same…

`prepare_global_references`

Create GLOBAL references (globalReferenceNode) pinned to ONE SPECIFIC row. Use this when a document must reference MULTIPLE DIFFERENT rows of the same table at once (e.g. Alice's email AND Bob's email, a roster, a comparison). Each reference is locked to the rowId you pass and is independent of the document's active row, so different references can point to different rows. Call lookup\_table\_rows first to get the rowId. Returns a mapping of columnId to tableReferenceId to use on globalReferenceNode nodes (markdown: \{\{globalref:ID}}). For the common case where ALL placeholders should share one row that the user can switch later, use prepare\_placeholder\_references instead. IMPORTANT: If you just created a new document, pass the documentId parameter with the new document's ID.

## Parameters

<ParamField path="tableId" type="string" required>
  The ID of the table whose columns you want to reference.
</ParamField>

<ParamField path="columnIds" type="array<string>" required>
  Array of column IDs to create global references for (all pinned to the same rowId).
</ParamField>

<ParamField path="rowId" type="string" required>
  Required. The specific row to pin these references to. Obtain from lookup\_table\_rows.
</ParamField>

<ParamField path="documentId" type="string">
  The target document ID. Required when no document is open in context. Falls back to the context documentId if omitted.
</ParamField>