---
title: "Query Smart Components"
slug: "query-smart-components"
tags: ["data-integration", "smart-components"]
updated: 2026-10-08T18:27:57Z
published: 2026-10-08T18:27:57Z
canonical: "docs.unqork.io/query-smart-components"
---

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

# Query Smart Components

Query Smart Components are a type of Smart Component that retrieves submission data. Instead of writing query logic directly, Creators describe what data they need in plain language. The UnqorkAI Build Agent generates the underlying query and creates or reuses a Smart Component to satisfy the requirements.

Query Smart Components are available to all AI-enabled environments.

![Module Builder canvas with qbRecentSubmissions selected, showing its settings panel with Component Type set to Query Component and a Result Outputs configuration](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261008_182755_2c24db3c8ac248e5b0bc96c375e4fbaf.png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A06Z&se=2026-11-09T04%3A51%3A06Z&sr=c&sp=r&sig=GViXGSWc1ik5HQzzDQOmOWnmedwKoJRDve1M3osewIw%3D)

## How to Use Query Smart Components

To create a Query Smart Component, do the following:

1. Open a module in the Module Builder.
2. Describe the data requirements to the UnqorkAI Build Agent. For example:

> "Create a query that accepts a status input parameter and retrieves submissions from schema 622131946701db01afdd79e8 where the status field matches it, sorted by creation date descending and limited to 10 results. Display the results in a table. The query should fire automatically whenever the status value changes."
3. The Build Agent creates or reuses a Smart Component to retrieve the data.

## Data Access

Query Smart Components retrieve submission records. At launch, Query Smart Components support **read operations**. Create, update, and delete operations are not supported.

## Data Privileging

Query Smart Components do not use Unqork User Groups or schema module RBAC settings. To control data access, apply restrictions at the application layer through Server-Side Execution.

Express RBAC controls are available at the query level. Administrators can assign invocation privileges to Express Roles, restricting which roles can invoke a specific Query Smart Component.

> [!NOTE]
> For more information on data access controls for Query Smart Components, contact your Unqork representative.

## Limitations

- **Read-only at launch**: Create, update, and delete operations are not supported.
- **Maximum records**: Queries return a maximum of 10,000 records.
- **File references**: Query Smart Components do not refresh authentication signatures on file links. To retrieve a working file link from a submission, use the `/getSubmissions` API.
- **Data Models**: Unqork Data Models are not supported at launch.
- **AI-enabled environments**: Query Smart Components require an AI-enabled environment.
- **`console` unavailable**: `console` is not available in query pipeline code. Calling `console.log()` or any other console method fails validation with the error "Identifier 'console' is not defined." To debug query pipeline behavior, use the [API Debugger](/unqorkai/docs/api-debugger) or review logs in the [Logs Dashboard](/unqorkai/docs/logs-dashboard).

> [!NOTE]
> The `/getSubmissions` API continues to work as it does today.

---

**Changelog**

| Date | Change |
| --- | --- |
| 2026-10-08 | Added console restriction to Limitations — `console` is not available in query pipeline code; validation error and debugging alternatives documented. |
| 2026-09-09 | Editorial pass — simplified intro (removed jargon); "Designers" → "Administrators"; "Technical Advisor" → "Unqork representative". |
| 2026-08-24 | Renamed from Smart Queries to Query Smart Components per SME review (Thomas Woo). |
| 2026-08-23 | Removed Search Mode section (moved to dedicated page). Added 10,000-record limit. Updated Smart Components framing and example prompt per SME review. |
| 2026-08-19 | Initial publication. |

A query lets you retrieve, access, manipulate, and delete data in a database.

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

Schema is a declarative language that defines the structure, content, and constraints of the data.

To execute or perform a a task. In the Operations builder, Events fire (execute) one, or multiple Operations.

RBAC (Role-Based Access Control) is a method to control system access for authorized users. The role in RBAC refers to the levels of access employees have to a network.

The Unqork front-end application framework that delivers Creator-built applications to end-users. Express is the layer end-users interact with—the published forms, screens, and navigation built in the Module Builder. Express is distinct from Express View, which is a Creator-facing preview tool in the IDE.

APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services.

Debugging is the process of finding and resolving errors or bugs in an application. To debug an application in Unqork, use UNQENG tools in Express View.