--- sourceDocument: brazil Combined Product Files sourceDocumentLink: https://www.servicenow.com/docs/r/delta-zurich-brazil Release : - brazil ft:locale : - en-US ft:publication_title : - brazil Combined Product Files ft:clusterId : - delta3bz bundleId : - delta3bz --- # Combined ServiceNow SDK release notes for upgrades from Zurich to Brazil # Combined ServiceNow SDK release notes for upgrades from Zurich to Brazil {#ariaid-title1} Release version: Brazil Updated October 8, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Combined ServiceNow SDK Release Notes for Upgrades from Zurich to Brazil This document consolidates the release notes for upgrading the ServiceNow SDK from the Zurich release family through Australia up to Brazil. It provides essential upgrade guidance, new features, changes, deprecations, and other relevant information to help ServiceNow customers manage their upgrade process effectively and utilize the latest SDK capabilities. Show full answer Show less ## Important Upgrade Information * **Upgrade Process:** To upgrade to the latest SDK version globally or per application, follow the instructions in the *Upgrade the ServiceNow SDK* documentation. The SDK supports ServiceNow instance integrations starting with the Washington DC release. * **Windows Credential Handling:** From SDK version 4.3 onwards, stored credentials on Windows are no longer supported due to Keytar deprecation. Users must re-authenticate using the `now-sdk auth --add` command. * **Minor Releases:** Additional notes and minor release updates are available on the ServiceNow SDK GitHub repository. * **Brazil Release:** No specific updates or changes were introduced in the Brazil release. ## New Features Introduced Between Zurich and Australia Releases * **Fluent APIs:** Extensive new ServiceNow Fluent APIs enable defining flows, service catalogs, email notifications, SLAs, dashboards, workspaces, import sets, UI policies, script actions, script includes, service portals, UI actions, and UI pages all in source code. * **Third-Party Module Access:** Control trusted third-party module access to ServiceNow APIs via the `trustedModules` parameter in `now.config.json`. * **Source Code Enhancements:** Attach user images to records, and use utility functions for type validation of complex field types like Duration, Time, Field List, and Template Value. * **Code Organization and Build Configuration:** Customize generated Fluent code directory structure and specify JavaScript module build inclusions/exclusions through configuration parameters. * **React UI Development:** Build full-stack applications using React integrated with the UI Page API. * **Application Metadata Management:** Download application metadata from instances, clean build artifacts, and package applications into installable ZIP files using SDK commands. * **Global Scope Support:** Create and convert global applications on Australia release instances and migrate global scope metadata into local global applications. * **Localization and UI Configuration:** Set default languages for field labels and control read-only options on fields via API configurations. ## Key Changes Across Releases * **TypeScript Enhancements:** Support for client-side TypeScript type checking and validation in full-stack applications, and improved dependency management via SDK commands. * **Expanded Column Type Support:** New column types such as Password2Column, GuidColumn, JsonColumn, and others are now supported in Fluent APIs. * **Testing Framework Enhancements:** Additional test steps are available in the Automated Test Framework API for attaching files and running server-side scripts. * **Build Process Changes:** The `now-sdk build` command no longer packages build artifacts; use `now-sdk pack` or `now-sdk install` for packaging. * **Flow API Improvements:** Integration of Service Catalog triggers and actions within the Flow API. * **Access Control Enhancements:** ACLs can now be protected using the `protectionPolicy` property. * **Static Asset Updates:** Keys for static UX assets in full-stack applications have been updated without changing the underlying sysids. ## Deprecations and Removals * The `now-sdk upgrade` command has been removed; upgrade instructions are now centralized in the upgrade documentation. * The `$id` property is deprecated in the List and Role APIs. * Property names using snake case are deprecated in all Fluent APIs; use camel case instead. * No features were removed between Zurich and Brazil releases. ## Activation and Requirements * The ServiceNow SDK is distributed as an npm package and installed locally. * Node.js and npm must be installed to use the SDK. * There are no new browser, accessibility, or localization requirements introduced between Zurich and Brazil. ## Highlights for ServiceNow Customers * Leverage new Fluent APIs to define complex business logic and UI components entirely in source code, enhancing customization and automation. * Build modern full-stack applications using React integrated with ServiceNow SDK capabilities. * Manage application metadata efficiently with SDK commands for downloading, cleaning, and packaging. * Upgrade smoothly with awareness of credential reauthentication on Windows and deprecated commands, ensuring continuous integration and deployment workflows. * Expand application scope Consolidated page of all release notes for ServiceNow SDK from Zurich to Brazil. ## How to use this page To help you prepare for your upgrade, we have combined the cross-family ServiceNow SDK release notes onto one page. Read this summary of the new features, changes, and updated information for your product from Zurich to Brazil. Tip: If there were no updates for a release notes section in a certain family release, we included a short note for your reference. For example, if a product did not have any updates in Tokyo, the row says "No updates for this release." ## Important information for upgrading ServiceNow SDK to Brazil Before you upgrade to Brazil, review these pre- and post-upgrade tasks and complete the tasks as needed. {#dfrn3-servicenowsdk-summary__entry__2} | Release | Release notes | |-|-| | Zurich | Upgrade information : To upgrade to the latest version of the ServiceNow SDK globally or within an application, see [Upgrade the ServiceNow SDK](https://www.servicenow.com/docs/access?context=upgrade-servicenow-sdk&family=zurich&ft:locale=en-US). ServiceNow SDK version 4.0 supports integration with ServiceNow instances beginning with the Washington DC release. On Windows systems, after upgrading to ServiceNow SDK version 4.3 or later, existing stored credentials aren't supported due to the deprecation of Keytar. Users on Windows systems must add their user credentials again using the `now-sdk auth --add` command to authenticate with instances. For more information, see [Authenticate](https://www.servicenow.com/docs/access?context=authenticate-instance-now-sdk&family=zurich&ft:locale=en-US). Note: For more information about minor releases of the ServiceNow SDK, see the [ServiceNow SDK repository](https://github.com/ServiceNow/sdk/releases) on GitHub. | | Australia | Upgrade information : To upgrade to the latest version of the ServiceNow SDK globally or within an application, see [Upgrade the ServiceNow SDK](https://www.servicenow.com/docs/access?context=upgrade-servicenow-sdk&family=australia&ft:locale=en-US). ServiceNow SDK version 4.4 supports integration with ServiceNow instances beginning with the Washington DC release. On Windows systems, after upgrading to ServiceNow SDK version 4.3 or later, existing stored credentials aren't supported due to the deprecation of Keytar. Users on Windows systems must add their user credentials again using the `now-sdk auth --add` command to authenticate with instances. For more information, see [Authenticate](https://www.servicenow.com/docs/access?context=authenticate-instance-now-sdk&family=australia&ft:locale=en-US). Important: For minor releases of the ServiceNow SDK, see the [ServiceNow SDK release notes](https://github.com/ServiceNow/sdk/releases) on GitHub. | | Brazil | No updates for this release. | [ ] ## New features Between your current release family and Brazil, new features were introduced for ServiceNow SDK. {#dfrn3-servicenowsdk-summary__entry__10} | Release | Release notes | |-|-| | Zurich | [Flow API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Flow API to create flows and subflows \[sys_hub_flow\] that automate business processes with reusable multiple-step components. [Service Catalog API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Service Catalog API to define catalog items \[sc_cat_item\] and related aspects of service catalogs. [Email Notification API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Email Notification API to define notifications \[sysevent_email_action\] that send automated emails. [Service Level Agreement API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Service Level Agreement API to define service level agreements (SLAs) \[contract_sla\] that set the amount of time for a task to reach a specified condition. [Dashboard API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Dashboard API to define dashboards \[par_dashboard\] for organizing and sharing data visually. [Workspace API - ServiceNow Fluent](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use the Workspace API to define configurable workspace experiences for organizing and sharing data visually. [Allow access to ServiceNow APIs for third-party modules](https://www.servicenow.com/docs/access?context=building-applications-source-code&family=zurich&ft:locale=en-US) : Configure which third-party library modules to identify as trusted and have access to ServiceNow APIs with the `trustedModules` parameter in an application's now.config.json file. [Import Sets API](https://www.servicenow.com/docs/access?context=fluent-import-sets-api&family=zurich&ft:locale=en-US) : Use the Import Sets API to define transform maps \[sys_transform_map\] that specify how to transform and map data from the import set staging table to target tables. [UI Policy API](https://www.servicenow.com/docs/access?context=fluent-ui-policy-api&family=zurich&ft:locale=en-US) : Use the UI Policy API to define user interface policies \[sys_ui_policy\] that dynamically change the behavior of information on a form and control custom process flows for tasks. [Attach user images to records from source code](https://www.servicenow.com/docs/access?context=fluent-constructs&family=zurich&ft:locale=en-US) : Attach user images to records associated with metadata defined in source code with the `Now.attach` construct. [Use utility functions for additional type validation](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&family=zurich&ft:locale=en-US) : Use utility types that help validate values for properties that support the Duration (Duration()), Time (Time()), Field List (FieldList()), and Template Value (TemplateValue()) field types in ServiceNow Fluent APIs. Utility types provide validation at build time for tables both within and outside of an application. [Generated ServiceNow Fluent code organized in taxonomy-based directories](https://www.servicenow.com/docs/access?context=building-applications-source-code&family=zurich&ft:locale=en-US) : Configure a custom directory structure for metadata transformed into ServiceNow Fluent code with the `taxonomy` parameter in an application's now.config.json file. By default, generated ServiceNow Fluent files are organized in a taxonomy-based directory structure within the fluent/generated directory. [Specify which files to build as JavaScript modules](https://www.servicenow.com/docs/access?context=building-applications-source-code&family=zurich&ft:locale=en-US) : Configure which files to include or exclude when building JavaScript modules with the `serverModulesIncludePatterns` and `serverModulesExcludePatterns` parameters in an application's now.config.json file. [Develop a user interface with React](https://www.servicenow.com/docs/access?context=ui-development-react&family=zurich&ft:locale=en-US) : Develop a user interface with the React library and the UI Page API to build a full-stack application in source code. [Script Action API](https://www.servicenow.com/docs/access?context=fluent-script-action-api&family=zurich&ft:locale=en-US) : Use the Script Action API to define script actions \[sysevent_script_action\] that run when an event occurs. [Script Include API](https://www.servicenow.com/docs/access?context=fluent-script-include-api&family=zurich&ft:locale=en-US) : Use the Script Include API to define script includes \[sys_script_include\] that store JavaScript functions and classes for use by server-side scripts. [Service Portal API](https://www.servicenow.com/docs/access?context=fluent-service-portal-api&family=zurich&ft:locale=en-US) : Use the Service Portal API to create custom widgets \[sp_widget\] for portal pages. [UI Action API](https://www.servicenow.com/docs/access?context=fluent-ui-action-api&family=zurich&ft:locale=en-US) : Use the UI Action API to configure custom user interface actions \[sys_ui_action\], such as buttons, links, and context menu items on forms and lists. [UI Page API](https://www.servicenow.com/docs/access?context=fluent-ui-page-api&family=zurich&ft:locale=en-US) : Use the UI Page API to configure custom user interface pages \[sys_ui_page\] that display forms, dialogs, lists, and other UI components. [Download application metadata from an instance](https://www.servicenow.com/docs/access?context=servicenow-sdk-cli-commands&family=zurich&ft:locale=en-US) : Download application metadata (XML) from a ServiceNow instance to compare it with the metadata in your local application using the `now-sdk download` command. [Clean or package an application](https://www.servicenow.com/docs/access?context=servicenow-sdk-cli-commands&family=zurich&ft:locale=en-US) : Remove the build artifacts that were output with the previous build using the `now-sdk clean` command. You can also package the build artifacts that were output with the previous build into an installable ZIP file using the `now-sdk pack` command. | | Australia | [Create and convert global applications](https://www.servicenow.com/docs/access?context=creating-applications-servicenow-sdk&family=australia&ft:locale=en-US) : Create and convert applications in the global scope that are accessible to other global applications with instances on the Australia release. [Move application metadata from the global scope into a global application](https://www.servicenow.com/docs/access?context=servicenow-sdk-cli-commands&family=australia&ft:locale=en-US) : Transform application metadata (XML) in the global scope from an instance into ServiceNow Fluent source code to customize it in a local global application using the `now-sdk move` command. [Configure a default language for field labels](https://www.servicenow.com/docs/access?context=building-applications-source-code&family=australia&ft:locale=en-US) : Configure a default language for field labels \[sys_documentation\] in a table or column with the `tableDefaultLanguage` parameter in an application's now.config.json file. [Configure read-only options with the Table API](https://www.servicenow.com/docs/access?context=table-api-now-ts&family=australia&ft:locale=en-US) : Control the editability of read-only fields by configuring read-only options for a field with the readOnlyOption property in a Column object. | | Brazil | No updates for this release. | [ ] ## Changes Between your current release family and Brazil, some changes were made to existing ServiceNow SDK features. {#dfrn3-servicenowsdk-summary__entry__18} | Release | Release notes | |-|-| | Zurich | [Get type checking and validation of client-side TypeScript files](https://www.servicenow.com/docs/access?context=ui-development-react&family=zurich&ft:locale=en-US) : Full-stack TypeScript applications support type checking and validation of .ts and .tsx files in the src/client directory when building applications. [Manage dependencies with additional parameters on the dependencies command](https://www.servicenow.com/docs/access?context=now-sdk-dependencies-command&family=zurich&ft:locale=en-US) : Control which dependencies and TypeScript definitions to download with additional parameters on the `now-sdk dependencies` command. [Use additional column types with ServiceNow Fluent](https://www.servicenow.com/docs/access?context=table-api-now-ts&family=zurich&ft:locale=en-US) : Use the following additional types of table columns with ServiceNow Fluent APIs: Password2Column, GuidColumn, JsonColumn, NameValuePairsColumn, UrlColumn, EmailColumn, HTMLColumn, FloatColumn, MultiLineTextColumn, DurationColumn, TimeColumn, FieldListColumn, SlushBucketColumn, TemplateValueColumn, and ApprovalRulesColumn. [Download TypeScript definitions for script includes used in JavaScript modules](https://www.servicenow.com/docs/access?context=download-script-dependencies&family=zurich&ft:locale=en-US) : Download TypeScript definitions for script includes imported in JavaScript modules from an instance using the `now-sdk dependencies` command. [Apply a template to an existing application](https://www.servicenow.com/docs/access?context=now-sdk-create-command&family=zurich&ft:locale=en-US) : Add template files and directories for development in ServiceNow Fluent using the `--template` parameter with the `now-sdk init` command in an existing application. [Automated Test Framework API supports additional test steps](https://www.servicenow.com/docs/access?context=atf-test-now-ts&family=zurich&ft:locale=en-US) : Use the following test steps with the ServiceNow Fluent Automated Test Framework API. * atf.form.addAttachmentsToForm * atf.form_SP.addAttachmentsToForm * atf.server.addAttachmentsToExistingRecord * atf.server.runServerSideScript * atf.server.setOutputVariables [Build command doesn't package build artifacts](https://www.servicenow.com/docs/access?context=servicenow-sdk-cli-commands&family=zurich&ft:locale=en-US) : Use the `now-sdk pack` or `now-sdk install` commands to package build artifacts. The `now-sdk build` command compiles the source files but doesn't package the build artifacts. | | Australia | [Flow API supports Service Catalog triggers and actions](https://www.servicenow.com/docs/access?context=fluent-flow-api&family=australia&ft:locale=en-US) : Use triggers and actions related to Service Catalog with the Flow API. [Access Control List API supports protection policies](https://www.servicenow.com/docs/access?context=acl-api-now-ts&family=australia&ft:locale=en-US) : Control whether someone can view or edit an access control list (ACL) with the protectionPolicy property in an ACL object. [Keys updated for static assets in full-stack applications](https://www.servicenow.com/docs/access?context=building-applications-source-code&family=australia&ft:locale=en-US) : Static UX Assets \[sys_ux_lib_asset\] in full-stack applications have updated keys in the keys.ts file. UX Asset sys_ids aren't changed. | | Brazil | No updates for this release. | [ ] ## Removed Between your current release family and Brazil, some ServiceNow SDK features or functionality were removed. {#dfrn3-servicenowsdk-summary__entry__26} | Release | Release notes | |-|-| | Zurich | No updates for this release. | | Australia | No updates for this release. | | Brazil | No updates for this release. | [ ] ## Deprecations Between your current release family and Brazil, some ServiceNow SDK features or functionality were deprecated. {#dfrn3-servicenowsdk-summary__entry__34} | Release | Release notes | |-|-| | Zurich | * The `now-sdk upgrade` command has been removed. To upgrade the version of the ServiceNow SDK, see [Upgrade the ServiceNow SDK](https://www.servicenow.com/docs/access?context=upgrade-servicenow-sdk&family=zurich&ft:locale=en-US). * The $id property is deprecated in the List API and Role API. * Property names that use snake case are deprecated in all ServiceNow Fluent APIs. Use the equivalent property name in camel case instead. | | Australia | No updates for this release. | | Brazil | No updates for this release. | [ ] ## Activation information Review information on how to activate ServiceNow SDK. {#dfrn3-servicenowsdk-summary__entry__42} | Release | Release notes | |-|-| | Zurich | Activation information : The ServiceNow SDK is available as a Node Package Manager (npm) package from the [public npm registry](https://www.npmjs.com/package/@servicenow/sdk) and installed locally. For information about installing the ServiceNow SDK, see [Install the ServiceNow SDK](https://www.servicenow.com/docs/access?context=install-servicenow-sdk&family=zurich&ft:locale=en-US). | | Australia | Activation information : The ServiceNow SDK is available as a Node Package Manager (npm) package from the [public npm registry](https://www.npmjs.com/package/@servicenow/sdk) and installed locally. For information about installing the ServiceNow SDK, see [Install the ServiceNow SDK](https://www.servicenow.com/docs/access?context=install-servicenow-sdk&family=australia&ft:locale=en-US). | | Brazil | No updates for this release. | [ ] ## Additional requirements If any additional requirements were introduced or changed for ServiceNow SDK we have noted them here. {#dfrn3-servicenowsdk-summary__entry__50} | Release | Release notes | |-|-| | Zurich | Additional requirements : You must have Node.js and Node Package Manager (npm) installed to install the ServiceNow SDK. For more information, see [Install the ServiceNow SDK](https://www.servicenow.com/docs/access?context=install-servicenow-sdk&family=zurich&ft:locale=en-US). | | Australia | Additional requirements : You must have Node.js and Node Package Manager (npm) installed to install the ServiceNow SDK. For more information, see [Install the ServiceNow SDK](https://www.servicenow.com/docs/access?context=install-servicenow-sdk&family=australia&ft:locale=en-US). | | Brazil | No updates for this release. | [ ] ## Browser requirements If any specific browser requirements were introduced or changed for ServiceNow SDK we have noted them here. {#dfrn3-servicenowsdk-summary__entry__58} | Release | Release notes | |-|-| | Zurich | No updates for this release. | | Australia | No updates for this release. | | Brazil | No updates for this release. | [ ] ## Accessibility information Review details on accessibility information for ServiceNow SDK, such as specific requirements or compliance levels. {#dfrn3-servicenowsdk-summary__entry__66} | Release | Release notes | |-|-| | Zurich | No updates for this release. | | Australia | No updates for this release. | | Brazil | No updates for this release. | [ ] ## Localization information If there are specific localization considerations for ServiceNow SDK we have noted them here. {#dfrn3-servicenowsdk-summary__entry__74} | Release | Release notes | |-|-| | Zurich | No updates for this release. | | Australia | No updates for this release. | | Brazil | No updates for this release. | [ ] ## Highlight information If there are specific highlight considerations for ServiceNow SDK we have noted them here. {#dfrn3-servicenowsdk-summary__entry__82} | Release | Release notes | |-|-| | Zurich | * Develop a user interface (UI) with React to build a full-stack application in source code. * Define flows, service catalogs, UI pages and more in source code with ServiceNow Fluent APIs. See [ServiceNow SDK](https://www.servicenow.com/docs/access?context=servicenow-sdk-landing&family=zurich&ft:locale=en-US) for more information. | | Australia | Create or convert applications in the global scope with instances on the Australia release. See [ServiceNow SDK](https://www.servicenow.com/docs/access?context=servicenow-sdk-landing&family=australia&ft:locale=en-US) for more information. | | Brazil | No updates for this release. | [ ]