This notice applies to NetSuite accounts with Suitelets that are available without login and accessed through a hard-coded external URLs. This notification is to inform you that, as of May 9, 2024, the format for external Suitelet URLs has been updated, and this updated format will be the only supported format in these accounts as of July 30.
An external Suitelet is a Suitelet that has the Available Without Login box checked on its script deployment record. After the deployment record has been saved with this option enabled, the External URL appears on the page.
What is changing?
Suitelets that are available without login have updated External URLs as of May 9, 2024. The new URL is displayed in the External URL field on the script deployment record for Suitelets that are available without login. The old URL will stop working on July 30, 2024.
Give special consideration to the following:
- All hardcoded URLs are impacted.
- Cases where the URL is resolved automatically using url.resolveScript() and similar methods do not require any action.
Hardcoded URLs can be found in various places:
- In scripts and HTML files in your account
- Occasionally, in other places like script parameters
- In external systems that retrieve information or trigger actions
- Links on your Web site
- In rare cases, where a Suitelet is used as a public Web site, it might be referenced by search engines
What to look for?
- A sample of an external URL, before any update:
/app/site/hosting/scriptlet.nl?script=123&deploy=123&h=ABCDFEFGHIJKLMNOPRSTUV - A sample of an external URL, after the update:
/app/site/hosting/scriptlet.nl?script=123&deploy=123&ns-at=KLMNOPRSTUVABCDFEFGHIJ
The effective change to the External URL is:
- &h=ABCDEFGHIJKLMONPQRSTUV is replaced by &ns-at=KLMONPQRSTUVBCDEFGHIJ
References pointing to the old external URL of the Suitelet will result in broken links after July 30, 2024.
Recommended actions
Update all existing hard-coded references to external URLs for Suitelets to use the new URL before July 30, 2024. After this date, all URLs using the old format will result in broken links.
- Locate any existing hard-coded URLs, including any scripts tied to the account or in external systems calling the external Suitelet with the external URL in the old format:
- Get the new URL of your external Suitelet:
- Go to the Script Deployment page of the Suitelet, and copy the updated external URL displayed there.
- Update the reference to the old URL of external Suitelets to use this new copied URL. Review all possible references, including the following situations:
- Requests to external Suitelets from external systems, including requests using HTTP verbs such as POST or PUT
- Weblinks
All requests using the old URL will throw an error after July 30, 2024.
For more information about External Suitelet URLs, see the Setting Available Without Login section of the Suitelet Script Deployment Page.
Additionally, we recommend reviewing the guidelines for usage of Suitelets marked Available Without Login and changing them to internal Suitelets when possible. See Suitelets and UI Object Best Practices and the Setting Available Without Login section of Suitelet Script Deployment Page.
If you require assistance or more information, please contact NetSuite Customer Support.