Why Gumloop Interfaces?
Without Interfaces, sharing workflows means users need to:- Navigate complex workflows
- Understand technical implementation details
- Handle data formats and connections correctly
- Creating simple interface designs
- Managing data processing behind the scenes
- Handling credentials seamlessly
- Delivering results directly to users
Creating an Interface
- In your workflow, click the “Add Interface” button on the top left panel
- A new Interface node appears in your workflow
- Hover over the Interface node and click ‘Edit Interface’
- Configure your interface:
- Add interface title and description
- Choose an interface icon:
- Upload custom image
- Select an emoji
- Add header image:
- Generate with AI: Describe what you want and get unique images
- Choose from galleries: Abstract, Nature, Gradients or Search on Unsplash
- Upload your own
Tip: Add detailed instructions in the AI image generation prompt to get the best output.
Understanding Interface Outputs
Input Type | Output in Workflow | Details |
---|---|---|
Text Field | Text string | Any text input from single words to paragraphs |
Number | Numeric value | Positive or negative numbers based on configuration |
Email string | Validated email address format | |
Date | ISO datetime | Standardized date format |
File Upload | File object | Supports PDF, PNG, CSV, XLSX, DOCX, MP4, MP3 and more (Max: 200MB) |
Dropdown | Text string | Value of the selected option |
Checkbox | Boolean | True when checked, False when unchecked |
Note: When a field is optional and left empty, it passes an empty value to your workflow
Interface Elements
Basic Inputs
Text Field
- Purpose: Collect written information
- Features:
- Single or multi-line text entry
- Set character limits for quality control
Number Input
- Purpose: Collect numeric values
- Features:
- Set minimum/maximum boundaries
- Guide users with placeholder examples
Email Field
- Purpose: Collect valid email addresses
- Features:
- Automatic format checking
- Prevents invalid submissions
Date Picker
- Purpose: Collect dates consistently
- Features:
- Visual calendar selection
- Outputs dates in ISO format
File Upload
- Purpose: Accept file submissions
- Features:
- Handle multiple files
- 200MB limit per file
- Support for common file types like PDF, DOC/DOCX, XLS/XLSX, CSV, TXT, MP3, MP4, JPEG, PNG, etc.
Interactive Elements
Select Dropdown
- Purpose: Present fixed choice options
- Features:
- Easily add/remove choices
- Set default selection
- Returns: Text of selected option
Checkbox
- Purpose: Yes/No selections
- Features:
- Starts unchecked by default
- Simple toggle interaction
Interface Structure
Organize your interface with:- Headings: Create clear sections
- Description Text: Guide users with explanations
- Dividers: Separate different parts visually
Tip: Drag and drop any element to reorder your interface layout
Input Configuration Options
Setting | Description | Usage Example |
---|---|---|
Custom Field Name | The name shown above the input | ”Phone Number” instead of default “Text” |
Helper Text | Guidance shown below the field | ”Include country code for international numbers” |
Placeholder | Example text in empty fields | ”+1 (555) 0123” |
Default Value | Pre-filled starting value | ”United States” in a country dropdown |
Required/Optional | Whether the field must be filled | Mark email as required for contact information |
Access & Security
Interface Access & Sharing
- Configure access settings through ‘Edit Interface Access’
- Access options:
- Restricted (default)
- Anyone with link: Accessible via shared URL
- Share interface link directly from the node
- Option to delete interface if needed
Workflow Visibility
- Toggle “Allow workflow access from interface”
- When enabled:
- Adds ‘View Workflow’ button to the interface
- Lets users see the underlying workflow
- Requires appropriate workflow permissions
Important Note: Interface access permissions are separate from workflow access permissions. This means:
- A user can have access to use an interface without having access to view or edit the underlying workflow
- Interface access and workflow access need to be configured separately
- You can share an interface widely while keeping the workflow private, or vice versa
Authentication & Credentials
- Users must sign in to Gumloop to use interfaces
- Important: When building workflows with service nodes (Gmail, Google Sheets, Slack, etc.):
- The flow will use the interface user’s credentials, not the workflow creator’s
- Users will need valid credentials for any services accessed in the workflow
- Example: If your workflow includes a
Gmail Sender
node:- The email will be sent from the interface user’s Gmail account, not yours
- The interface user will need to connect their Gmail account when using the interface
- Credentials connect directly to services
- Nothing stored by Gumloop
Usage & Credits
- Credits are deducted from the interface user’s account/organization
- If the user belongs to an organization, credits are deducted from the organization’s balance
- Creator’s credits are not affected
- Interfaces show the same output as the workflow
- Interface inputs connect directly to workflow inputs
Interface Management
- Users with workflow edit access can modify the interface
- Interfaces work with both triggered and non-triggered workflows
- You can use an ‘Output’ node to output any data in the interface once the flow has successfully ran
- Interface output supports markdown formatting