---
generated_by: gdlink-build
generated_at: 2026-06-23T12:34:28Z
do_not_edit: true
title: Print
brick_type: executor
tier: Basic
generated: true
---

# Print

**Category:** Executor
**Tier:** Basic

## Purpose

Writes deterministic probe lines to the console for demo verification, debugging, and lightweight value inspection.

## Visual Reference

```{raw} html
<div class="illustration-container"><div class="illustration-box"><div class="box-header">As added to your scene</div><img src="https://gdlink.solventech.ca/guide/assets/images/bricks/print_executor.png" alt="Print brick as it appears in the GDLink editor" loading="lazy" style="max-width:100%;height:auto;display:block;margin:0 auto;border-radius:8px;" /></div></div>
```

## Runtime Behavior

**Inputs**
- **Activate** (Boolean): Emits one console line when the executor is triggered.

**Properties**
- **message** (String, `""`)
  - Base message text written to the console.
  - Supports template token substitution:
    - `{name}`
    - `{position}`
    - `{velocity}`
    - `{speed}`
    - `{mouse_pos}`
    - `{mouse_delta}`
- **include_timestamp** (Bool, `true`)
  - When enabled, prepends an elapsed-seconds timestamp in the form `[123.456] `.
- **variable_name** (String, `""`)
  - Optional variable name to append after the message as ` | name=value`.
- **scope** (Enum, `Global`)
  - `Local`: reads from the target node's `metadata/local_variables`.
  - `Global`: reads from `/root/GDLinkGlobals`.

```{raw} html
<div class="illustration-container">
        <div class="illustration-box">
            <div class="box-header">Generated UI Mockup — showing expanded properties</div>
            <div class="real-node brick-executor">
                <div class="real-header">
                    <div class="real-title"><span class="brick-icon-fallback"></span> <span>Print</span></div>
                    <div class="real-controls"><div class="real-checkbox"></div><div class="real-btn">-</div><div class="real-btn">x</div></div>
                </div>
                <div class="real-inner-panel"><div class="real-row name-row" style="position:relative;"><span class="real-label">Name:</span><div class="real-input" style="color:#666; font-style:italic;">Label this brick...</div><div class="real-port" style="left:-15px;"></div></div><div class="real-row"><span class="real-label" style="width:auto; max-width:160px; overflow:hidden; text-overflow:ellipsis;">Message:</span><div class="real-input" style="flex-grow:0; width:120px; justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-row"><span class="real-label" style="width:auto; max-width:160px; overflow:hidden; text-overflow:ellipsis;">Include Timestamp:</span><div class="real-input" style="flex-grow:0; width:120px; justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-row"><span class="real-label" style="width:auto; max-width:160px; overflow:hidden; text-overflow:ellipsis;">Variable Name:</span><div class="real-input" style="flex-grow:0; width:120px; justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-row"><span class="real-label" style="width:auto; max-width:160px; overflow:hidden; text-overflow:ellipsis;">Scope:</span><div class="real-input" style="flex-grow:0; width:120px; justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div></div>
            </div>
        </div>
    </div>
```

## Properties

| Property | Type | Default | Notes |
|---|---|---|---|
| Message | string | Debug Output | Text to print to console |
| Timestamp | bool | True | Prepend timestamp to output |
| Variable | variable_name |  | Optional: Print value of a variable |
| Scope | option | Global | Read variable from global or local scope |