topic Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo in CMS Development

HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpot UI

MAsghari — Wed, 18 Sep 2024 10:34:19 GMT

Hi There,

I'm deploying a custom UI Extension in HubSpot that includes serverless functions. Locally, everything works fine, but once I deploy, I encounter the following error:

{ "status": "error", "message": "The serverless function 'handle-report' failed to execute: Cannot find module './services/handle-report-service'\nRequire stack:\n- /var/task/test.js\n- /var/task/hubspotHandler.js\n- /var/runtime/index.mjs." }

I'm attempting to require a local module from in 'handle-report' which is a serverless function:

// Services const HandleReportService = require('./services/handle-report-service'); exports.main = async (context = {}) => { ----- }

In local development, this works perfectly, and the module is found as expected. However, once the extension is deployed in the HubSpot environment, using 'hs project upload' the serverless function fails with a "Cannot find module" error.

What I've Tried:

Using Relative Paths (./services/handle-report-service😞
Using path.join() and path.resolve() with __dirname:
Testing process.cwd():
Double-checking the folder structure:
- The services/handle-report-service.js file is present locally and is deployed as part of the extension.
Checking deployment settings and logs:
- I reviewed the deployment logs, but nothing indicates why this file isn't being found.

Can you help me to understand the problem?

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

KhushbooP11 — Wed, 18 Sep 2024 11:53:01 GMT

Hi @MAsghari,

The issue likely stems from how HubSpot handles paths in the serverless environment after deployment. In a serverless setup, the directory structure may differ from local development, so relative paths don't always behave as expected.

Here’s what you can do:

1. Check that the filename and the import path match exactly, including case sensitivity. Serverless environments may be stricter about this than local ones.

2. Try switching from relative paths (./services/handle-report-service) to absolute paths by using path.resolve() to ensure the correct module path:

const path = require('path');
const HandleReportService = require(path.resolve(__dirname, './services/handle-report-service'));

3. Verify that the services/handle-report-service.js file is included in the build when you deploy the project using hs project upload. Sometimes, files may not be uploaded if excluded in deployment settings.

4. If the issue persists, try cleaning the project (delete build artifacts) and re-deploying it using hs project upload.

This should help resolve the path issue in the serverless environment.

I hope it helps, let me know if you need to talk!

Khushboo Pokhriyal

Growth & Operations

GroRapid Labs

LinkedIn | 9315044754 | Email | Website

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

MAsghari — Thu, 19 Sep 2024 09:03:15 GMT

Hi, Thanks for your response,

I Already tried all of them, none of them will work!

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

MAsghari — Fri, 04 Oct 2024 09:06:16 GMT

Hi There!

Any feedback/solution for this?

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

MAsghari — Thu, 10 Oct 2024 08:07:15 GMT

Hi @kennedyp

Can you please check this question and send it to one your specialist to check!

I'd appreciate if @zach_threadint can take a look at this!

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

kennedyp — Wed, 16 Oct 2024 21:16:01 GMT

Thanks for the tag, @MAsghari! I want to invite some subject matter experts to see if they have any suggestions.

Hey @danmoyle, @Mike_Eastwood , @Teun do you have any thoughts on this?

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

MAsghari — Mon, 25 Nov 2024 14:33:14 GMT

Hi @kennedyp Can you please check if anyone has an answer for this? I keep receiving this error for multiple projects and have no idea how to fix it. The provide answers up to now are not correct!

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

craigjacksonids — Fri, 17 Oct 2025 22:27:04 GMT

Sorry to bother, I know it has been a while but I am chasing this issue myself. Did you find a solution?

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

chighsmith — Mon, 20 Oct 2025 16:38:50 GMT

Hi @craigjacksonids,

Thank you for posting to the Community!

It doesn't look like we've found a solution to this yet; however, let's tag in some Top Contributors to see if they have any ideas -- Hi @LauraMarie @ArisudanTiwari and @kosalaindrasiri. Do you have any suggestions?

Thank you!

Cassie, Community Manager

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

LauraMarie — Mon, 20 Oct 2025 17:57:23 GMT

What platform version are you using? Remember that version 2025.2 does NOT handle serverless functions. Make sure you're using 2025.1

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

LauraMarie — Mon, 20 Oct 2025 18:03:28 GMT

What platform version are you using? Remember that version 2025.2 does NOT handle serverless functions. Make sure you're using 2025.1

Re: HubSpot UI Extension | Serverless Function Fails to Find Local Module After Deployment in HubSpo

craigjacksonids — Mon, 20 Oct 2025 23:33:07 GMT

Hi,
Thanks for your response.

It is 2025.1 but I eventually found a hubspot article saying the local
includes are not supported with Hubspot's serverless functions so I just
have to cut and paste common routines into each function

Cheers,
Craig