Help Center

Get help and find answers to common questions about Minimal.

Browse by Category

Getting Started

Learn the basics and set up Minimal

Integration Guide

Platform-specific setup instructions

Customization

Personalize appearance and behavior

Analytics

Understanding your metrics

Troubleshooting

Common issues and solutions

API Reference

Developer documentation

Getting Started with Minimal

Create Your Account

Add Your Website

Click "Add New Site" in your dashboard, enter your website URL, and you'll receive a unique Site ID. This ID connects Minimal to your website.

Install the Script

Copy the provided script and paste it before the closing </body> tag on your website. The widget will appear automatically.

<script src="https://minimal.lat/embed.js" data-site-id="your-site-id"></script>

Customize & Launch

From your dashboard, customize colors, position, greeting messages, and more. Changes apply instantly – no need to update your code!

Integration Guide

Choose your platform and follow the installation instructions. Need help? Check our detailed integration page.

Web Platforms

Install Minimal on any website with a simple script tag or use our framework-specific packages.

HTML/JavaScript - One line script tag
React - npm package with hooks
Vue.js - Plugin for Vue 3
Angular - Native module
Next.js - Optimized for SSR

E-commerce & CMS

Native integrations for popular platforms with easy dashboard configuration.

WordPress - Plugin from repository
Shopify - App from app store
WooCommerce - WordPress extension
Webflow - Custom code integration
Squarespace - Code injection

Advanced Customization

Configuration Using Attributes

You can customize Minimal directly in the script tag using data attributes:

<script
  src="https://minimal.lat/embed.js"
  data-site-id="your-site-id"
  data-position="bottom-right"
  data-theme="auto"
  data-language="en"
></script>

Customization Options

Position: bottom-right, bottom-left, top-right, top-left

Theme: light, dark, auto (follows system preference)

Language: en, es, fr, de, pt, and more

Greeting: Any custom text for the initial message

Primary Color: Hex color code (e.g., #10b981)

Advanced JavaScript Configuration

For more control, use JavaScript configuration:

window.MinimalConfig = {
  siteId: 'your-site-id',
  position: 'bottom-right',
  theme: 'auto',
  language: 'en',
  greeting: 'Hi there! How can we help?',
  placeholder: 'Type your message...',

  // Advanced options
  autoOpen: false,
  autoOpenDelay: 3000, // milliseconds
  hideOnPages: ['/checkout', '/payment'],
  showOnPages: ['*'], // all pages by default

  // Styling
  customColors: {
    primary: '#10b981',
    background: '#ffffff',
    text: '#1f2937'
  },

  // Behavior
  collectEmail: true,
  requireEmail: false,
  enableFileUploads: true,
  maxFileSize: 10 // MB
};

<script src="https://minimal.lat/embed.js"></script>

Understand Your Analytics

Engagement Metrics

Track how visitors interact with your chat:

Widget Views: Number of times the widget was displayed
Open Rate: Percentage of visitors who opened the chat
Messages Sent: Total messages from visitors
Conversations Started: New conversation threads
Average Response Time: How quickly you respond

User Insights

Understand your visitor behavior:

Peak Hours: When visitors are most active
Popular Pages: Where conversations start
Device Breakdown: Desktop vs. mobile usage
Geographic Data: Where your visitors come from
Returning Visitors: Track repeat interactions

Conversion Tracking

Measure business impact:

Lead Capture Rate: Percentage of chats that collect emails
Qualified Leads: Conversations marked as sales-ready
Goal Completions: Custom conversion events
Revenue Attribution: Sales linked to chat interactions
ROI Metrics: Return on investment calculations

Frequently Asked Questions

How do I customize the widget colors?

You can customize colors in two ways:

Dashboard: Go to Settings → Appearance and use the color picker to choose your brand colors.
Code: Use the customColors option in JavaScript configuration:

customColors: {
  primary: '#10b981',    // Main accent color
  background: '#ffffff', // Chat background
  text: '#1f2937'       // Text color
}

Can I hide the widget on specific pages?

Yes! Use the hideOnPages configuration option:

hideOnPages: ['/checkout', '/payment', '/admin/*']

Supports wildcards for pattern matching. You can also use showOnPages to only display on specific pages.

How do I integrate with Google Analytics?

Minimal automatically tracks events that you can capture in Google Analytics:

window.addEventListener('minimal:message', function(e) {
  gtag('event', 'chat_message_sent', {
    'event_category': 'engagement',
    'event_label': 'Chat Interaction'
  });
});

See our Integration Guide for more analytics platforms.

What happens if I reach my plan limits?

We'll notify you via email when you reach 80% of your plan limits. If you exceed:

Conversations: The widget continues working, but you'll need to upgrade to access new conversations in the dashboard.
Pageviews: Tracking continues, and you can upgrade anytime to access full analytics.

Your visitors will never see any interruption in service.

Troubleshooting

Common issues and how to resolve them.

Widget Not Appearing

If the widget doesn't show up on your site:

Verify the script is placed before the closing </body> tag
Check that your Site ID is correct in the dashboard
Ensure JavaScript is enabled in your browser
Clear your browser cache and hard reload (Ctrl+Shift+R or Cmd+Shift+R)
Check browser console for any error messages

Widget Position Issues

If the widget appears in the wrong position or overlaps other elements:

Adjust the position setting in your dashboard (bottom-right, bottom-left, etc.)
Check for CSS conflicts with high z-index values on your site
Use custom CSS to override positioning if needed
Try different offset values to avoid overlapping with other fixed elements

Conversations Not Saving

If conversations aren't appearing in your dashboard:

Verify you're logged into the correct account
Check that you're viewing the correct site in the dashboard
Ensure your plan hasn't reached conversation limits
Allow a few minutes for data synchronization
Contact support if the issue persists after 15 minutes

Styling Not Applied

If custom colors or styles aren't showing:

Changes in the dashboard apply instantly - no code updates needed
Clear browser cache to see latest styling changes
Check that custom CSS isn't overriding your settings
Verify color values are in valid hex format (e.g., #10b981)

API Reference

JavaScript API for advanced control and customization.

Widget Control Methods

// Open the widget
Minimal.open();

// Close the widget
Minimal.close();

// Toggle widget state
Minimal.toggle();

// Check if widget is open
const isOpen = Minimal.isOpen(); // returns boolean

// Destroy the widget instance
Minimal.destroy();

Event Tracking

// Track custom events
Minimal.trackEvent('event_name', {
  customData: 'value',
  userId: '12345'
});

// Set user context
Minimal.setContext({
  userId: 'user_123',
  email: 'user@example.com',
  plan: 'premium'
});

// Identify user
Minimal.identify({
  userId: 'user_123',
  name: 'John Doe',
  email: 'john@example.com'
});

Event Listeners

// Listen for widget events
window.addEventListener('minimal:open', () => {
  console.log('Widget opened');
});

window.addEventListener('minimal:close', () => {
  console.log('Widget closed');
});

window.addEventListener('minimal:message', (event) => {
  console.log('Message sent:', event.detail);
});

window.addEventListener('minimal:ready', () => {
  console.log('Widget initialized');
});

Configuration Updates

// Update configuration at runtime
Minimal.updateConfig({
  theme: 'dark',
  position: 'bottom-left',
  greeting: 'New greeting message'
});

// Get current configuration
const config = Minimal.getConfig();

Need More Help?

Can't find what you're looking for? Our support team is here to help.

Contact Support View Full Docs

Average response time: under 2 hours