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)andtable.uploadAttachmentAsync(record, field, file, options): Upload a file into an Attachment field. The file can be text, bytes (Uint8Array,Buffer,ArrayBuffer) or aBlob/File, for example frominput.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 andfetchto upload files.nocodb.readAttachmentAsync(attachment): Downloads a file of an Attachment cell and returns its bytes, name, type and size.
Links
record.linkAsync(),record.unlinkAsync(),table.linkRecordsAsync()andtable.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()anddeleteRecordsAsync()accept any number of records. NocoDB sends them 10 per request. Earlier, these methods accepted at most 10 records. updateRecordAsync()returns the saved record, andupdateRecordsAsync()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
filteroption forselectRecordsAsync()andcountRecordsAsync(): A structured filter in the shape of the NocoDB API v3, with nestedANDandORgroups. 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
wherestrings, with a message that tells you how to correct them.
Errors and reliability
NocoDBError: Failed methods throw aNocoDBErrorwithstatus,code,operationand, 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
Fieldobjects apply.
Breaking change
view.selectRecordAsync()reads the record through the view. It resolves tonullif the view filters the record out, and the record has only the fields that the view shows, even if you name a hidden field infields, as withview.selectRecordsAsync(). Earlier, it ignored the view and returned every field. To read a field that the view hides, usetable.selectRecordAsync().
Note: The other changes do not break existing scripts.
February 17, 2026
Links Field Enhancement
- 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()andview.selectRecordAsync(). - For Has-Many (HM) and Many-to-Many (MM) relationships, linked records now come back as
LazyRecordQueryResultobjects. 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.configmethods now accept an optionaldefaultparameter.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: 7input.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 optionaldefaultValueparameter 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.
- Example:
- Default Values for
input.selectAsync(): Added an optionaldefaultValueparameter.- Example:
await input.selectAsync('Select option:', options, defaultValue) - The dropdown menu shows this option as selected.
- Example:
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')orconst 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.
- Use the
July 28, 2025
Script Steps API
- Added
scriptobject: 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
baseobject: Access to project metadata and configurationtableobject: Create and read operations on tablesrecordobject: Many record operationsfieldobject: Field metadata and validationinputobject: Methods that collect user inputoutputobject: Many output formatting optionsfetchfunction: HTTP requests to external APIssessionobject: 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
- Documentation: Scripts API Reference
- Examples: Script Examples
- Community: NocoDB Forums
- Issues: GitHub Issues
For questions about specific API changes or help with migration, contact our community or support team.
Last updated on
Latest product updates?See Changelog