Web app settings control how your published applications look and behave for end users. Every Dify application automatically generates a web interface that adapts to different devices and screen sizes.
How Settings Work#
Your web app reflects your application’s current configuration. When you modify settings and click Publish, changes flow immediately to the live web application that users are accessing.
Web apps are public by default. Anyone with the URL can access them, which works well for demos, public tools, and customer-facing applications.
Branding and Appearance#
Make your web app look professional and recognizable:
Set your app name, description, and icon to create a clear first impression
Choose colors, themes, and layout options that match your brand
Configure interface language for your target audience
Add copyright information and privacy policy links for compliance
Essential Branding Elements#
App Icon and Name
- Your icon appears in browser tabs and when users bookmark your app
- Choose a clear, recognizable name that explains what your app does
- Icons can be images or emojis; pick what fits your app’s personality
Description and Messaging
- Write a concise description that helps users understand your app’s purpose
- This text appears on the app’s landing page and in search results
- Keep it under 160 characters for best results
Input Placeholder
- Replace the default hint text in the chat input box with a prompt of your own, up to 64 characters
- Available for chat-style apps (Chatbot, Agent, and Chatflow); leave it empty to keep the default
Visual Consistency
- Choose colors that align with your brand
- Consider your audience when selecting light or dark themes
- Test your app on different devices to ensure it looks good everywhere
Access Controls#
Web apps are public by default. Anyone with the URL can open them, which works well for demos, public tools, and customer-facing applications.
On Dify Enterprise, you can restrict who opens a web app with authentication, member-level access, and external-user management. Contact sales to learn more.
Privacy and Legal:
- Add copyright information and privacy policy links
- Configure data handling preferences
- Set terms of service for compliance
Feature Inheritance#
Your web app automatically includes features you’ve enabled in your app configuration:
Interactive Features:
- Conversation openers and suggested follow-ups
- Pre-conversation forms for context gathering
- Voice input and speech-to-text capabilities
- Source citations and reference links
- Feedback collection and rating systems
Functionality:
- All workflow steps and AI model configurations
- Knowledge base integrations and tool connections
- Custom prompts and response formatting
- Rate limiting and usage controls
Disabling features in your app configuration immediately removes them from the published web app.
App Types and Behavior#
Your web app automatically adapts its interface based on your app type:
Interface: Conversation-style with message history Features: Persistent sessions, conversation management, real-time responses Best for: Customer support, consulting tools, interactive assistants
Interface: Form-based with result display Features: Single runs, batch processing, result saving Best for: Content generation, data processing, analysis tools
Deployment Options#
Once published, your web app can be accessed in multiple ways:
Share the web app URL for immediate access
Deploy as chat widgets or iframes on existing websites
Publishing Best Practices#
Before sharing your web app:
Test the user experience
Try your app on different devices and browsers to ensure it works smoothly.
Configure essential settings
Set up your app name, icon, description, and any required legal information.
Review access controls
Decide if your app should be public or require authentication.
Choose deployment method
Determine whether to share directly or embed on your website.
Your web app configuration applies everywhere it’s deployed. Changes to settings automatically update embedded versions too.