> ## Documentation Index
> Fetch the complete documentation index at: https://docs.howly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

Most issues come down to the HubSpot connection, portal size, or your browser. Here's how to handle the ones that come up most.

## Workflows won't load

If the canvas can't load your automations, you'll usually see a message asking you to reconnect. The fastest fixes, in order:

<Steps>
  <Step title="Refresh">
    Click the refresh button to pull fresh data from HubSpot, bypassing any cached session data.
  </Step>

  <Step title="Reconnect HubSpot">
    If it keeps happening, disconnect and reconnect your HubSpot portal. The connection token may have expired or been revoked on the HubSpot side.
  </Step>

  <Step title="Check your HubSpot access">
    Make sure the HubSpot account you connected still has access to the portal you're trying to view.
  </Step>
</Steps>

## "HubSpot is experiencing high traffic"

On large portals, HubSpot's API occasionally rate-limits the sync. Howly retries automatically a few times before showing this message.

If you see it, wait a minute and try again. It's temporary and almost always clears on its own. Howly batches its API calls specifically to respect HubSpot's rate limits, so it won't disrupt your other integrations.

## The first load is slow

The first sync pulls every workflow in your portal and maps the connections between them.

* Most portals load in 10 to 15 seconds.
* Portals with 100 or more workflows can take up to 25 seconds.

After the first load, your data is cached for the session, so moving around the app is fast. To see changes you made in HubSpot, refresh.

## An export or report didn't open

Howly opens exports and reports in a new browser view. If nothing happens when you export, your browser most likely blocked a pop-up.

<Steps>
  <Step title="Allow pop-ups for Howly">
    Allow pop-ups for app.howly.io in your browser settings.
  </Step>

  <Step title="Try the export again">
    Re-run the export. It should open normally once pop-ups are allowed.
  </Step>
</Steps>

## A workflow is active but shows no activity

This isn't a bug. A workflow can be switched on and still enroll no records, because the list it pulls from changed, a property was renamed, or the campaign behind it ended.

Check the enrollment count in the workflow's detail panel. It shows how many records the workflow has actually enrolled in the last 30 days, so you can tell what's genuinely running from what's just switched on.

## The map looks empty or filtered

If the canvas shows no workflows, you probably have active filters that nothing matches. Clear or adjust your filters, or press `Escape` to close search, and the full map returns. Filters persist across refreshes by design, so they can carry over from a previous session.

## Signed out unexpectedly

Howly requires an active sign-in to load your portal. If you're signed out, log back in at [app.howly.io](https://app.howly.io) and reconnect your portal if prompted.

## Still stuck?

Email [support@howly.io](mailto:support@howly.io) and include your portal size (roughly how many workflows) and what you were doing when it happened. That's usually enough to pin down the cause quickly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.