Changelog

This page lists all changes to the NocoDB Scripts API: new features, improvements, bug fixes and breaking changes.

November 20, 2026

Files

  • record.uploadAttachmentAsync(field, file, options) and table.uploadAttachmentAsync(record, field, file, options): Upload a file into an Attachment field. The file can be text, bytes (Uint8Array, Buffer, ArrayBuffer) or a Blob/File, for example from input.fileAsync(). NocoDB adds the file after the files that the cell already has, and returns the saved record. You no longer need an API token and fetch to upload files.
  • nocodb.readAttachmentAsync(attachment): Downloads a file of an Attachment cell and returns its bytes, name, type and size.
  • record.linkAsync(), record.unlinkAsync(), table.linkRecordsAsync() and table.unlinkRecordsAsync(): Add or remove only the links that you give. Other links of the record stay. Earlier, a script had to write the whole Links field, which replaced all links.

Records

  • Batches of any size: createRecordsAsync(), updateRecordsAsync() and deleteRecordsAsync() accept any number of records. NocoDB sends them 10 per request. Earlier, these methods accepted at most 10 records.
  • updateRecordAsync() returns the saved record, and updateRecordsAsync() returns the saved records. Earlier, they returned nothing.
  • table.upsertRecordsAsync(records, { matchOn }): Creates or updates records, matched on one to three fields.
  • countRecordsAsync() on tables and views: Counts the records that match a filter.

Filters

  • filter option for selectRecordsAsync() and countRecordsAsync(): A structured filter in the shape of the NocoDB API v3, with nested AND and OR groups. NocoDB puts quotes around names and values for you. See Filters.
  • Checked where strings: The script editor marks unknown fields, wrong operators, and date conditions without a sub-operator in where strings, with a message that tells you how to correct them.

Errors and reliability

  • NocoDBError: Failed methods throw a NocoDBError with status, code, operation and, for batches, details.completedIds. The error messages do not change. See Errors.
  • Retried reads: NocoDB retries reads after network errors and HTTP 502, 503 and 504. NocoDB does not retry writes.

API access

  • nocodb.requestAsync(): Calls the NocoDB API v3 of the current project as the user who runs the script, without an API token.

Editor

  • Autocomplete suggests the fields of each table, and for a filter, the operators and values that suit the chosen field.
  • The editor no longer suggests system fields such as nc_order, but still accepts them.
  • The types the editor adds for filters and files start with Nc (NcFilter, NcRecordRef, …), so they do not clash with names in your script.

Fixes

  • getCellValueAsString() formats rollups the same way the grid shows them: currency, whole-number counts and dates.
  • Buttons and workflow scripts format numbers with thousands separators, as the script editor does.
  • "Load more" on linked records works. Sorts given as Field objects apply.

Breaking change

  • view.selectRecordAsync() reads the record through the view. It resolves to null if the view filters the record out, and the record has only the fields that the view shows, even if you name a hidden field in fields, as with view.selectRecordsAsync(). Earlier, it ignored the view and returned every field. To read a field that the view hides, use table.selectRecordAsync().

Note: The other changes do not break existing scripts.

February 17, 2026

  • Links as LinkToAnotherRecord (LTAR) Support: Links fields now return the full data of linked records. Earlier, they returned only counts.
    • All record query methods automatically include the full linked record information (id and display value).
    • This applies to table.selectRecordsAsync(), view.selectRecordsAsync(), table.selectRecordAsync() and view.selectRecordAsync().
    • For Has-Many (HM) and Many-to-Many (MM) relationships, linked records now come back as LazyRecordQueryResult objects. Earlier, these relationships returned only counts.
    • For Belongs-To (BT) and One-to-One (OO) relationships, linked records come back as complete record objects, as before.
    • Note: This change applies automatically to all scripts. You do not have to change your code.

January 29, 2026

Script Settings Enhancement

  • Default Values for Configuration Items: All input.config methods now accept an optional default parameter.
    • input.config.table(): Pre-select a table by ID: default: 'tbl_abc123'
    • input.config.view(): Pre-select a view by ID: default: 'vw_xyz789'
    • input.config.field(): Pre-select a field by ID: default: 'fld_email456'
    • input.config.text(): Pre-fill the text input: default: 'Weekly Report'
    • input.config.number(): Pre-fill the number input: default: 7
    • input.config.select(): Pre-select a dropdown option: default: 'medium'
    • If the user gives no value, the script uses the default value. Good defaults make scripts easier to use.

October 03, 2025

Input Methods Enhancement

  • Default Values for input.textAsync(): Added an optional defaultValue parameter in the options object.
    • Example: await input.textAsync('Enter name:', {defaultValue: 'Anonymous'})
    • The input field shows the default value. The user can accept it or change it.
  • Default Values for input.selectAsync(): Added an optional defaultValue parameter.
    • Example: await input.selectAsync('Select option:', options, defaultValue)
    • The dropdown menu shows this option as selected.

External Package Imports

  • Dynamic Import Support: Scripts can now import external JavaScript packages from a CDN with dynamic imports.
    • Use the await import('package-name') syntax to load external libraries.
    • Example: const _ = await import('lodash') or const dayjs = await import('dayjs')
    • Supported CDNs: esm.sh (default), unpkg, skypack and jsdelivr.
    • You can use libraries such as lodash, dayjs and axios.
    • Note: Only dynamic imports work. Static imports are not available.

July 28, 2025

Script Steps API

  • Added script object: A new global object that creates visual steps.
  • script.step(config): Creates and starts a step, with many options.
    • Supports titles, descriptions, icons and colors.
    • Steps are managed automatically: the previous step ends when a new step starts.
    • Use the string shorthand script.step('Step Title') or a full config object.
  • script.clear(): Ends the current step manually.
  • script.colors: Predefined color constants (red, blue, green, yellow, purple, orange, gray).
  • script.icons: An icon library with more than 100 icons in different categories.

Improvements

  • The script timeout increased to 30 Minutes.

June 30, 2025

Initial Scripts Release

  • base object: Access to project metadata and configuration
  • table object: Create and read operations on tables
  • record object: Many record operations
  • field object: Field metadata and validation
  • input object: Methods that collect user input
  • output object: Many output formatting options
  • fetch function: HTTP requests to external APIs
  • session object: Script run context and state

Core Functionality

  • JavaScript runtime: Full ES6+ support
  • Async/await support: Modern asynchronous programming
  • Error handling: Full error reports
  • Type safety: TypeScript definitions for all APIs

Support and Resources

For questions about specific API changes or help with migration, contact our community or support team.

Last updated on

Latest product updates?See Changelog
Stay in the loop? Follow us onLinkedInLinkedInYouTubeYouTubeXX