# Twilee

> Twilee is a QR code management platform. Create dynamic QR codes, customize their design, track scans with analytics, and manage everything through a web dashboard, REST API, or MCP integration.

Twilee provides 16 QR code types split into two categories: standard (URL, email, call, SMS, vCard, file, WiFi, mobile app) and advanced/hosted (links, text, event, audio, business, lost-found, survey, photo gallery). All QR codes created on the platform are dynamic: their destination can be changed at any time without reprinting. Hosted QR code types come with customizable landing pages.

Website: https://twilee.com
Documentation: https://twilee.com/docs
API base URL: https://api.twilee.com
Status page: https://status.twilee.com

---

## What is a Dynamic QR Code?

A dynamic QR code is a QR code whose destination can be changed at any time without reprinting. Unlike static QR codes where data is encoded directly into the pattern, dynamic QR codes encode a short redirect URL. When scanned, the redirect URL forwards the user to the actual destination, which can be updated at any time from the Twilee dashboard. Every scan is tracked with analytics including country, city, device type, and timestamp.

### Dynamic vs Static QR Codes

Static QR codes have fixed content that cannot be changed once generated. The data (URL, text, WiFi credentials) is encoded directly into the QR code pattern. They work without any server and never expire, but they cannot be edited, tracked, or analyzed after creation.

Dynamic QR codes are editable, trackable, and offer advanced features like scan analytics and file uploads. They encode a short redirect URL that points to Twilee's servers, which then forwards the scanner to the actual destination. This indirection allows changing the destination at any time, tracking every scan, and enabling features like hosted landing pages.

---

## QR Code Types

### Standard QR Code Types

**URL QR Code**: Redirects to any website URL. The most common QR code type. Change the destination URL at any time without reprinting. Supports scan tracking and analytics.

**Email QR Code**: Opens the user's email client with pre-filled recipient, subject, and body. Useful for customer feedback, support requests, or event RSVPs.

**Call QR Code**: Initiates a phone call to a specified number when scanned. Used for customer support lines, sales contacts, or emergency numbers.

**SMS QR Code**: Opens the SMS app with a pre-filled phone number and message. Useful for opt-in campaigns, voting systems, or quick feedback.

**vCard QR Code**: Downloads a digital contact card (VCF file) containing name, phone, email, address, company, title, and website. Commonly used on business cards and name badges.

**File QR Code**: Downloads or displays a file (PDF, image, document) hosted on Twilee. The file can be replaced at any time without changing the QR code. Supports file uploads up to the plan's storage limit.

**WiFi QR Code**: Connects to a WiFi network automatically when scanned. Encodes the network name (SSID), password, and encryption type (WPA/WPA2/WEP/None). No app required on modern smartphones.

**Mobile App QR Code**: Redirects users to the appropriate app store (Apple App Store or Google Play Store) based on their device. A single QR code serves both iOS and Android users.

### Advanced QR Code Types (Hosted Pages)

These QR code types include a hosted landing page that is fully customizable with your branding. Pages are served from Twilee's CDN for fast loading worldwide.

**Links QR Code**: A link-in-bio style page with multiple clickable links. Customize with your brand colors, logo, and header image. Each link can have a title, description, and icon. Similar to Linktree but integrated with your QR codes.

**Text QR Code**: A hosted page displaying rich text content with formatting. Supports headings, paragraphs, bold, italic, and links. Useful for instructions, menus, or informational content.

**Event QR Code**: Share event details on a hosted page with calendar integration. Displays event name, date, time, location, description, and a map. Visitors can add the event to their Google Calendar, Apple Calendar, or Outlook with one tap.

**Audio QR Code**: A hosted page with an audio player. Upload MP3, WAV, or other audio files. Useful for museum tours, music samples, podcasts, or audio guides. Includes playback controls and track information.

**Business QR Code**: A business profile page with contact information, business hours, location with map, social media links, and a description. Functions as a lightweight digital business card or landing page.

**Lost & Found QR Code**: Tag items or pets with a QR code that displays contact information when scanned. The finder sees the owner's message and contact details. Useful for luggage tags, pet collars, key chains, and valuable items.

**Survey QR Code**: Collect feedback via a hosted survey form. Create questions with multiple choice, text input, or rating scales. Responses are collected and can be exported. Useful for customer satisfaction, event feedback, or market research.

**Photo Gallery QR Code**: Display a photo gallery on a hosted page. Upload multiple images served via CDN with fast loading. Includes lightbox viewing, captions, and responsive grid layout.

---

## Key Features

### Dynamic QR Code Management
Create, edit, activate, deactivate, and delete QR codes from the dashboard. Change the destination URL or content at any time. Organize QR codes with custom color-coded tags. Bulk operations available for managing large numbers of QR codes.

### Visual Customization
Customize QR code appearance with colors, gradients, corner shapes, dot shapes, and patterns. Add your company logo to the center of the QR code. Choose from predefined styles or create custom designs. Save styles for reuse across multiple QR codes. Adjust error correction level (L/M/Q/H) to balance scannability and design flexibility.

### Scan Tracking and Analytics
Track every scan in real time. View analytics broken down by country, city, device type, browser, operating system, and time period. Visualize data with timeline charts and geographic maps. Export scan data for further analysis. Available for all dynamic QR code types.

### Page View Analytics
For hosted page QR code types, track page views separately from scans. A scan happens when the QR code is scanned; a page view happens when the hosted page is loaded (which can also happen via direct URL access or shared links).

### Team Collaboration
Invite team members to your workspace. All QR codes are shared within the team. Assign roles: Admin (manages team members and roles) and Billing (manages subscription and payments). Paid plans support multiple team members.

### Bulk Operations
- Bulk import: Create multiple QR codes at once from a CSV file
- Bulk visual design: Apply a visual style to multiple QR codes simultaneously
- Bulk image export: Download QR code images in bulk as a ZIP archive

### Custom Domains
Use your own domain for branded short URLs instead of the default Twilee domain. Configure a CNAME record to point your domain to Twilee. Available on paid plans.

### Hosted Landing Pages
Eight QR code types (links, text, event, audio, business, lost-found, survey, photo gallery) include hosted landing pages. Pages are mobile-optimized, fast-loading via CDN, and customizable with brand colors, logos, and header images. No website or hosting required.

### Email Reports
Configure automated email reports (daily, weekly, or monthly) summarizing scan activity, new QR codes, and key metrics for your team.

---

## Pricing

All prices are in USD. EUR pricing available at https://twilee.com/en-eu/pricing.

### Free Plan: $0/month
- 1 dynamic QR code
- Up to 500 scans (QR code stops redirecting after limit)
- All 16 QR code types
- Basic analytics (country-level)
- QR code visual customization
- 1 team member

### Starter Plan: $5.90/month ($4.90/month billed annually)
- 20 dynamic QR codes
- Unlimited scans
- All 16 QR code types
- Advanced analytics (country, city, device, browser, OS)
- QR code visual customization
- Logo upload
- File uploads (100 MB storage)
- Priority support
- Up to 3 team members

### Premium Plan: $18.90/month ($15.75/month billed annually)
- 100 dynamic QR codes
- Unlimited scans
- All 16 QR code types
- Advanced analytics
- QR code visual customization
- Logo upload
- File uploads (500 MB storage)
- Custom domain
- Priority support
- Up to 10 team members
- Saved styles
- Email reports

### Business Plan: $69.90/month ($58.25/month billed annually)
- 10,000 dynamic QR codes
- Unlimited scans
- All 16 QR code types
- Advanced analytics
- QR code visual customization
- Logo upload
- File uploads (2 GB storage)
- Custom domain
- Priority support
- Up to 50 team members
- Saved styles
- Email reports
- Role management
- API access
- MCP integration

### Enterprise Plan: Custom pricing
- Flexible cloud deployment (AWS, GCP, Azure)
- Custom integrations
- Dedicated support
- Custom SLA
- Contact sales for a personalized quote

All paid plans include 2 months free when billed annually.

---

## Frequently Asked Questions

### What is a QR Code Generator?
A QR code generator is a tool that allows you to create custom QR codes for various purposes. QR codes are scannable codes that store information, such as URLs, contact details, WiFi credentials, or text, which can be instantly accessed by scanning the code with a smartphone or device. With a QR code generator, you can customize these codes to suit your branding, making it an innovative and convenient way to share information quickly and effectively.

### Can I use the generated QR codes for commercial use?
Yes, absolutely. The QR codes generated using Twilee can be freely used for commercial purposes. Whether you're promoting a product, sharing business information, or enhancing customer experiences, the QR codes are designed to support your commercial and professional needs without any restrictions.

### What is the difference between a static and a dynamic QR code?
Static QR codes have fixed content that cannot be changed once the code is generated. They are straightforward but lack flexibility. Dynamic QR codes allow you to edit the content or destination even after the QR code is created. Additionally, dynamic QR codes enable tracking and analytics, letting you monitor scans (location, time, device). They also offer advanced features like file uploads and hosted landing pages. Dynamic QR codes are the smarter choice for anyone looking to adapt, track, and optimize their QR code usage.

### How can I scan a QR code?
Open your smartphone's camera, point it at the code, and tap the link that appears. If your phone doesn't support this, use a QR scanner app (available for free on app stores). You can also use tools like Google Lens or QR scanners built into some browsers or devices.

### Can I customize the design of the QR code?
Yes. Twilee offers extensive customization: custom foreground and background colors to match your brand palette, personalized labels with editable text and font options, and brand integration with logos (pre-built logos for platforms like YouTube, LinkedIn, Facebook, or upload your own). You can also choose dot shapes, corner shapes, and apply gradients.

### Do QR Codes Expire?
On the free plan, QR codes are limited to 500 scans per code. On paid plans, dynamic QR codes remain active as long as the subscription is active. If a subscription is canceled or unpaid, there is a 7-day grace period before QR codes stop redirecting.

### Are there any ads?
No. There are absolutely no ads. When users scan your QR codes, they are directed to your intended destination without any interruptions or third-party advertisements.

### What types of QR codes are available?
All plans include access to 16 different QR code types: URL, Email, Call, SMS, vCard, File Upload, WiFi, Mobile App, Event, Text, Links (link-in-bio), Audio, Business, Survey, Photo Gallery, and Lost & Found. Several of these types include hosted landing pages that are fully customizable.

### How is pricing calculated for dynamic QR codes?
Starter Plan: $5.90/month for 20 dynamic QR codes. Premium Plan: $18.90/month for 100 dynamic QR codes. Business Plan: $69.90/month for 10,000 dynamic QR codes. All plans include unlimited scans. Pay annually to get 2 months free.

### Can I upgrade or downgrade my plan?
Yes. You can change your plan at any time. Upgrades take effect immediately with prorated billing. Downgrades take effect at the end of your current billing period.

---

## REST API

Base URL: https://api.twilee.com
Authentication: Bearer token (API key generated from the Team dashboard)
Response formats: JSON, JSON-LD

### Endpoints

**QR Codes API** (`/api/qr-codes`): Create, read, update, delete, and download QR codes programmatically. Supports all 16 QR code types. Filter by type, tag, status. Pagination supported.

**Scan Logs API** (`/api/scan-logs`): Retrieve scan history with timestamps, country, city, device, browser, and OS data. Filter by QR code, date range, country.

**Page Views API** (`/api/page-views`): Retrieve hosted page view analytics with timestamps and location data. Available for hosted page QR code types.

Full API documentation: https://twilee.com/docs/api/getting-started

---

## MCP Integration

Twilee provides a Model Context Protocol (MCP) integration that allows AI assistants (Claude, ChatGPT, Cursor, etc.) to manage QR codes, access analytics, and automate tasks.

Available MCP tools include: creating QR codes, listing QR codes, updating destinations, retrieving scan analytics, uploading files, exporting data, and managing settings.

MCP setup guide: https://twilee.com/docs/mcp/mcp-getting-started
Tools reference: https://twilee.com/docs/mcp/tools-reference

---

## Privacy and Compliance

- All data hosted in France/EU (GDPR compliant)
- No data transfers outside the European Economic Area
- Stripe for payment processing (PCI DSS compliant)
- 90-day scan log retention
- No third-party tracking or advertising
- No ads displayed on QR codes or hosted pages
- Sub-processors listed at https://twilee.com/sub-processors
- Privacy policy: https://twilee.com/privacy
- Terms of service: https://twilee.com/tos

---

## Free Tools

Twilee offers free tools that do not require an account:

- **QR Code Scanner**: Scan QR codes using your device camera (https://twilee.com/tools/qr-scanner)
- **QR Code Size Calculator**: Calculate the optimal print size for QR codes based on scanning distance (https://twilee.com/tools/size-calculator)
- **WiFi QR Code Generator**: Generate a static WiFi QR code (https://twilee.com/tools/wifi-qr-code)
- **vCard QR Code Generator**: Generate a static vCard QR code (https://twilee.com/tools/vcard-qr-code)
- **Event QR Code Generator**: Generate a static event QR code (https://twilee.com/tools/event-qr-code)

---

## Documentation Index

### Getting Started
- Sign up with Google, Apple, LinkedIn, or email: https://twilee.com/docs/getting-started/sign-up
- Create your first dynamic QR code: https://twilee.com/docs/guides/create-your-first-dynamic-code
- What does QR Code stand for: https://twilee.com/docs/getting-started/what-qr-code-stands-for

### Core Concepts
- Dynamic QR Codes: https://twilee.com/docs/core-concepts/dynamic-qr-codes
- QR Code Types overview: https://twilee.com/docs/core-concepts/qr-code-types
- Hosted Pages: https://twilee.com/docs/core-concepts/hosted-page
- How It Really Works: https://twilee.com/docs/core-concepts/how-it-really-works

### Feature Guides
- Edit QR Code Name: https://twilee.com/docs/guides/edit-qr-code-name
- Add Your Logo: https://twilee.com/docs/guides/add-your-logo-on-the-qr-code
- Adjust Correction Level: https://twilee.com/docs/guides/adjust-the-correction-level
- Download Printable QR Code: https://twilee.com/docs/guides/download-a-printable-qr-code
- Activate/Deactivate QR Code: https://twilee.com/docs/guides/activate-deactivate-qr-code
- Customize Inactive Page: https://twilee.com/docs/guides/customize-inactive-page
- Bulk Import from CSV: https://twilee.com/docs/guides/bulk-import-qr-codes
- Bulk Image Export: https://twilee.com/docs/guides/bulk-image-export
- Bulk Visual Design Update: https://twilee.com/docs/guides/bulk-visual-design
- Saved Styles: https://twilee.com/docs/guides/saved-styles
- Email Reporting: https://twilee.com/docs/guides/reporting-settings
- Custom Domain: https://twilee.com/docs/guides/custom-domain
- Tags: https://twilee.com/docs/guides/tags
- Analytics: https://twilee.com/docs/guides/scan-and-page-view-analytics
- Team Collaboration: https://twilee.com/docs/guides/team-collaboration

### QR Code Type Guides
- URL: https://twilee.com/docs/qr-code-types/url
- Email: https://twilee.com/docs/qr-code-types/email
- Call: https://twilee.com/docs/qr-code-types/call
- SMS: https://twilee.com/docs/qr-code-types/sms
- vCard: https://twilee.com/docs/qr-code-types/vcard
- File: https://twilee.com/docs/qr-code-types/file
- WiFi: https://twilee.com/docs/qr-code-types/wifi
- Links: https://twilee.com/docs/qr-code-types/links
- Text: https://twilee.com/docs/qr-code-types/text
- Event: https://twilee.com/docs/qr-code-types/event
- Audio: https://twilee.com/docs/qr-code-types/audio
- Business: https://twilee.com/docs/qr-code-types/business
- Lost & Found: https://twilee.com/docs/qr-code-types/lost-found
- Mobile App: https://twilee.com/docs/qr-code-types/app-download
- Survey: https://twilee.com/docs/qr-code-types/survey
- Photo Gallery: https://twilee.com/docs/qr-code-types/photo-gallery