Skip to main content
hideBackButtons hides back navigation buttons in the widget UI. Use it when you want to keep users in a specific flow—for example, during a guided link experience where returning to the flow or connector list would break the intended path.

Where it applies

hideBackButtons is supported in three places in Widget v3:
SurfaceTypeDescription
<Widget />React propHides back buttons for flows opened through the widget container.
<Connections />React propHides back buttons for inline connection flows rendered in your app.
link()Function parameterHides back buttons when opening the widget directly to a connector.

React: Widget

Pass hideBackButtons to <Widget /> when you mount the widget container in your app:
import { useHotglue, Widget } from "@hotglue/widget";

export default function WidgetLauncher() {
  const tenantId = "MY-TENANT-ID";
  const { openWidget } = useHotglue({
    tenantId,
    environmentId: process.env.NEXT_PUBLIC_HOTGLUE_ENV_ID,
    apiKey: process.env.NEXT_PUBLIC_HOTGLUE_PUBLIC_KEY,
    jwtToken: "<TENANT SCOPED JWT>",
  });

  return (
    <div>
      <Widget hideBackButtons />
      <button onClick={() => openWidget(tenantId)}>Open Widget</button>
    </div>
  );
}

React: Connections

Pass hideBackButtons to <Connections /> for inline connection flows:
import { useHotglue, Connections } from "@hotglue/widget";

export default function ConnectionsLauncher() {
  useHotglue({
    tenantId: "MY-TENANT-ID",
    environmentId: process.env.NEXT_PUBLIC_HOTGLUE_ENV_ID,
    apiKey: process.env.NEXT_PUBLIC_HOTGLUE_PUBLIC_KEY,
    jwtToken: "<TENANT SCOPED JWT>",
  });

  return <Connections hideBackButtons />;
}
Pass hideBackButtons when calling link() to open the widget to a specific connector. This is the most common use case—it prevents users from navigating back to the flow selection screen after you deep-link them into a connector.
hotglue.link({
  tenantId: "tenant-123",
  connectorId: "shopify",
  flowId: "aw3hH39",
  hideBackButtons: true,
});
See the full link reference for all supported parameters.