Changelog

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

October 03, 2025

Input Methods Enhancement

• Default Values for input.textAsync() - Added optional defaultValue parameter in options object
  • Example: await input.textAsync('Enter name:', {defaultValue: 'Anonymous'})
  • Pre-fills the input field with a default value that users can accept or modify
• Default Values for input.selectAsync() - Added optional defaultValue parameter
  • Example: await input.selectAsync('Select option:', options, defaultValue)
  • Pre-selects an option in the dropdown menu

External Package Imports

• Dynamic Import Support - Scripts can now import external JavaScript packages from CDN using dynamic imports
  • Use await import('package-name') syntax to load external libraries
  • Example: const _ = await import('lodash') or const dayjs = await import('dayjs')
  • Supports popular CDNs: esm.sh (default), unpkg, skypack, jsdelivr
  • Enables use of libraries like lodash, dayjs, axios, etc.
  • Note: Only dynamic imports are supported; static imports are not available

July 28, 2025

Script Steps API

• Added script object - New global object for creating visual steps
• script.step(config) - Create and start steps with rich customization options
  • Support for titles, descriptions, icons, and colors
  • Automatic step management (previous step ends when new step starts)
  • String shorthand: script.step('Step Title') or full config object
• script.clear() - Manually end the current step
• script.colors - Predefined color constants (red, blue, green, yellow, purple, orange, gray)
• script.icons - Comprehensive icon library with 100+ icons across different categories.

Improvements

• Increased script timeout to 30 Minutes

June 30, 2025

Initial Scripts Release

• base object - Access to base metadata and configuration
• table object - Create, Read operations on tables
• record object - Rich record manipulation capabilities
• field object - Field metadata and validation
• input object - User input collection methods
• output object - Rich output formatting options
• fetch function - HTTP requests to external APIs
• session object - Script execution context and state

Core Functionality

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

Support and Resources

• Documentation: Scripts API Reference
• Examples: Script Examples
• Community: NocoDB Discord
• Issues: GitHub Issues

For questions about specific API changes or migration help, please reach out to our community or support team.