Skip to main content
Hosted Pages let you publish your agent on a dedicated URL at gumloopagents.com. Instead of sharing access to the Gumloop builder, you give people a clean, focused chat interface where they can interact with your agent directly.

Dedicated URL

Each agent gets its own your-agent.gumloopagents.com link that people can bookmark and open directly.

Focused Chat Surface

People use the agent from a standalone chat page instead of navigating through the Gumloop builder.

No Separate App Needed

The hosted page uses the same agent instructions and tools you already configured in Gumloop.

Control Access Anytime

Update the URL alias or disable the hosted page whenever you want.

​
Setting Up a Hosted Page

1

Open the Hosted Page Channel

Navigate to your agent, then click Hosted Page under External Channels in the sidebar.
External Channels sidebar showing Email, Slack, Microsoft Teams, and Hosted Page options
You’ll see a page describing the feature and its benefits.
Hosted Page setup page showing benefits and Enable Hosted Page button
2

Enable the Hosted Page

Click Enable Hosted Page. Gumloop automatically generates a URL alias based on your agent’s name. The alias follows the format:
your-agent-name.gumloopagents.com
You can copy the URL using the copy button, or click the pencil icon to customize the alias.
3

Share the Link

Share the hosted page URL with anyone who needs to use the agent. When they open the link, they’ll see a standalone chat interface with your agent’s name and icon.
Hosted page chat interface showing the agent name, tools, and message input

​
Customizing the URL Alias

You can change the hosted page alias at any time:
  1. Click the pencil icon next to the current URL
  2. Type your desired alias (3-64 characters, lowercase letters, numbers, and hyphens only)
  3. Press Enter or click the checkmark to save
The alias must be unique across all Gumloop agents. If the alias you want is already taken, you’ll need to choose a different one.
Certain aliases like admin, api, app, auth, beta, docs, gumstack, help, localhost, mcp, sandbox, staging, support, ws, and www are reserved and cannot be used.

​
Authentication and Sign-In

Hosted pages require users to sign in before they can chat with the agent. Here’s how the authentication flow works:
  1. A visitor opens the hosted page URL (e.g., your-agent.gumloopagents.com)
  2. The page resolves the agent alias and loads the agent’s profile (name, icon, tools)
  3. The visitor is prompted to sign in through Gumloop’s authentication
  4. After signing in, a secure one-time session token is exchanged, and the visitor is redirected back to the hosted page with full chat access
The sign-in session is scoped to the hosted page domain. Authentication uses a secure broker flow where credentials never pass through the hosted subdomain directly.

​
Permissions and Access

Hosted pages use the same permission system as the rest of Gumloop. Each role determines what a user can do both on the hosted page itself and in the configuration panel within the Gumloop builder.
Permission LevelHosted Page (Chat)Builder Config PanelConversation History
Owner / EditorChat with the agentEnable/disable hosted page, change aliasView all conversations from all users
ViewerChat with the agentView settings (read-only)View all conversations from all users
Use-OnlyChat with the agentNo accessOnly their own conversations
The “view all conversations” ability requires workspace-level access (being a member of the agent’s project or an organization admin). Users who are individually shared into an agent only see their own conversations, regardless of their role.
The hosted page chat interface automatically hides features that aren’t relevant for the surface:
  • No configuration panel: Users cannot see or modify agent settings from the hosted page
  • No external channel management: The sidebar for Email, Slack, and other channels is hidden
  • No app-level navigation: The hosted page doesn’t show the Gumloop builder navigation
Users can still share individual chat links directly from the hosted page. Only users with Editor or Owner access can enable, disable, or modify the hosted page configuration. These roles carry the manage_hosting permission required for these actions. Organization administrators can also restrict hosted pages through App Rules if needed.
Hosted Pages is a Pro feature. Free-tier users will see an upgrade prompt when attempting to enable a hosted page.

​
Credits and Billing

Conversations on hosted pages consume credits the same way as regular agent chats in the Gumloop builder. The credit cost depends on:
  • AI model usage: Token consumption based on the model your agent uses
  • Tool calls: Each MCP integration or workflow execution costs credits
  • Conversation length: Longer conversations with more context use more tokens
Credits are charged to the account of the person chatting. For team agents where users belong to the same organization, credits come from the shared organization credit pool. If a user outside your organization has been shared into the agent, their usage is deducted from their own credit balance.
Monitor credit usage from the Credits page. If you’re sharing hosted pages widely, consider setting up credit alerts.

​
Credentials and Integrations

When someone interacts with your agent through a hosted page, the agent uses the chatting user’s own credentials. This is the same behavior as Slack, the Gumloop builder, and all other surfaces. This means:
  • MCP integrations (Gmail, Slack, Salesforce, etc.) use the chatting user’s connected accounts
  • Workflows run with the chatting user’s credentials
  • API keys (BYOK or platform-provided) are resolved from the chatting user’s account
If a hosted page user hasn’t connected a required integration (e.g., Google Docs), they will be prompted to connect it before the agent can use that tool on their behalf.
Each user’s actions through the hosted page use their own connected accounts. Make sure users understand which integrations the agent may use on their behalf.

​
Disabling a Hosted Page

To disable a hosted page:
  1. Navigate to the Hosted Page channel in your agent’s sidebar
  2. Click Disable Hosted Page in the status section
Disabling the hosted page immediately makes the URL inaccessible. The alias reservation is preserved, so if you re-enable later, you can use the same alias (unless it’s been claimed by another agent in the meantime).

​
FAQ

Hosted pages are currently served on the gumloopagents.com domain only. Custom domains are not supported at this time.
Yes. Users are prompted to sign in when they first visit a hosted page. If they don’t already have a Gumloop account, one is created during the sign-in process. This ensures secure access and proper credit tracking.
Access is controlled through Gumloop’s standard sharing and permissions system. Users need at least Use-Only level access to the agent. This can come from being directly shared into the agent, being a member of the agent’s workspace project, or having organization-level access. Organization admins can also restrict hosted pages entirely via App Rules.
Changing the alias updates the URL. Existing conversations are preserved in the agent’s chat history and remain accessible to users who sign in again on the new URL.
Yes. The hosted page is a responsive web interface that works on mobile browsers. Users can open the URL on any device and interact with the agent.
Hosted pages are designed to be opened as standalone pages at their gumloopagents.com URL. Embedding via iframe is not officially supported. If you need to embed an agent in your own site, consider using the Gumloop API to build a custom integration.
Credits are charged to the person chatting. For team agents where all users are in the same organization, this comes from the shared organization credit pool. Users outside the organization use their own credits.
Sharing an agent gives someone access through the Gumloop builder, where they see the full navigation, configuration options, and other workbooks. A hosted page provides a standalone, distraction-free chat surface at a dedicated URL. Use hosted pages when you want people to interact with your agent without needing to navigate the Gumloop platform.
It depends on your role and how you were given access. Owners, Editors, and Viewers who are members of the agent’s workspace can see all conversations from all users. Use-Only users, and any user who was individually shared into the agent (rather than being a workspace member), can only see their own conversations.
For agents in a team workspace, any workspace member with the appropriate role can access the hosted page. Organization admins automatically get Owner-level access. Members of the agent’s workspace project inherit their project-level role. The agent’s tools and integrations remain the same regardless of who is chatting.