Documentation

Introduction

Welcome to the ttny.io documentation. This guide will help you understand how to use our URL shortening service effectively. Whether you're a content creator, marketer, or developer, you'll find everything you need to create, manage, and track your short links.

What is ttny.io?

ttny.io is a powerful URL shortening service that allows you to create short, memorable links that redirect to longer URLs. Our platform provides detailed analytics, custom domains, and a range of features to help you manage your links effectively.

Key Features

• Custom Short Links: Create branded, memorable links with your own keywords
• Detailed Analytics: Track clicks, locations, devices, and more
• Custom Domains: Use your own domain for short links
• Link Management: Organize links with tags, folders, and search
• Team Collaboration: Share access with team members
• API Access: Integrate with your applications
• QR Codes: Generate QR codes for your links

Creating Links

Creating short links with ttny.io is quick and easy. You can create links from the dashboard, browser extension, or API.

From the Dashboard

1. Log in to your ttny.io account
2. On the dashboard, locate the URL shortener box at the top
3. Paste your long URL in the input field
4. Click the "Shorten" button
5. Your new short link will be generated instantly

Custom Links

You can create custom short links with your own keywords:

1. Paste your long URL in the input field
2. Click the "Customize" button next to the input field
3. Enter your desired custom path (e.g., "summer-promo")
4. Click the "Shorten" button
5. Your custom short link (e.g., ttny.io/summer-promo) will be created

Link Options

When creating a link, you can set various options:

• Title: Add a descriptive title to help identify your link
• Tags: Add tags to organize your links
• Expiration Date: Set an expiration date for temporary links
• Password Protection: Add password protection to your link
• UTM Parameters: Add UTM parameters for campaign tracking
• Custom Domain: Use a custom domain for your link (if configured)

Managing Links

ttny.io provides powerful tools to help you organize and manage your links effectively.

Link Dashboard

The link dashboard displays all your links in a grid or list view. From here, you can:

• View all your links
• Search for specific links
• Filter links by tags, date, or status
• Sort links by clicks, date created, or title
• Edit or delete links
• Copy links to clipboard
• Generate QR codes

Organizing Links

You can organize your links using tags and folders:

Tags

Tags are labels that you can add to your links to categorize them. You can add multiple tags to a link and filter your links by tag.

1. Click the "Edit" button on a link
2. Add or remove tags in the tags field
3. Click "Save" to update the link

Folders

Folders allow you to group related links together. You can create nested folders to organize your links hierarchically.

1. Click the "New Folder" button in the sidebar
2. Enter a name for the folder
3. Click "Create" to create the folder
4. Drag and drop links into the folder

Bulk Operations

You can perform operations on multiple links at once:

1. Select multiple links by checking the checkboxes
2. Click the "Bulk Actions" button
3. Choose an action (e.g., delete, add tags, move to folder)
4. Confirm the action

Analytics

ttny.io provides detailed analytics for your short links, helping you understand how your links are performing.

Link Analytics

To view analytics for a specific link:

1. Click on a link in your dashboard
2. Click the "Analytics" tab
3. View detailed analytics for the link

Available Metrics

ttny.io tracks the following metrics for your links:

• Total Clicks: The total number of clicks on your link
• Unique Clicks: The number of unique visitors who clicked your link
• Click History: A timeline of clicks over time
• Geographic Data: The countries and cities where your link was clicked
• Referrers: The websites or platforms that referred traffic to your link
• Devices: The devices used to click your link (mobile, desktop, tablet)
• Browsers: The browsers used to click your link
• Operating Systems: The operating systems used to click your link

Dashboard Analytics

The dashboard provides an overview of your link performance:

• Total Clicks: The total number of clicks across all your links
• Top Links: Your most clicked links
• Click Trends: A chart showing click trends over time
• Geographic Distribution: A map showing where your clicks are coming from

Exporting Analytics

You can export analytics data for further analysis:

1. Go to the Analytics tab for a link
2. Click the "Export" button
3. Choose a format (CSV, Excel, PDF)
4. Click "Download" to export the data

Custom Domains

With ttny.io, you can use your own domain for short links, enhancing your brand presence and recognition.

Setting Up a Custom Domain

To set up a custom domain:

1. Go to Settings > Domains
2. Click "Add Domain"
3. Enter your domain (e.g., links.yourdomain.com)
4. Follow the DNS configuration instructions
5. Wait for DNS propagation (may take up to 48 hours)
6. Verify your domain

DNS Configuration

You'll need to add the following DNS records to your domain:

Using Your Custom Domain

Once your custom domain is verified, you can use it for your short links:

1. When creating a new link, click the domain dropdown
2. Select your custom domain from the list
3. Continue creating your link as usual

Managing Multiple Domains

You can add multiple custom domains to your account and use different domains for different purposes:

• Use different domains for different campaigns or products
• Set a default domain for new links
• Transfer links between domains

API

ttny.io provides a powerful API that allows you to integrate our URL shortening service into your applications.

Getting Started with the API

To use the API, you'll need an API key:

1. Go to Settings > API
2. Click "Generate API Key"
3. Copy your API key and keep it secure

Basic API Usage

Here's a simple example of creating a short link using the API:

curl -X POST https://api.ttny.io/v1/links \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "url": "https://example.com/very/long/url",
  "title": "My Example Link"
}'

API Libraries

We provide official client libraries for popular programming languages:

• JavaScript/Node.js: npm install ttny-api
• Python: pip install ttny-api
• PHP: composer require ttny/api
• Ruby: gem install ttny-api

Integrations

ttny.io integrates with a wide range of tools and platforms to streamline your workflow.

Available Integrations

Setting Up Integrations

To set up an integration:

1. Go to Settings > Integrations
2. Click on the integration you want to set up
3. Follow the instructions to connect your account
4. Configure the integration settings

Zapier Integration

Our Zapier integration allows you to connect ttny.io with 3,000+ apps:

• Create short links when new content is published
• Send notifications when links are clicked
• Add link click data to spreadsheets or databases
• Create custom workflows based on link activity

Account Settings

Manage your ttny.io account settings to customize your experience and secure your account.

Profile Settings

To update your profile information:

1. Go to Settings > Profile
2. Update your name, email, or profile picture
3. Click "Save Changes"

Security Settings

Enhance the security of your account:

• Change Password: Regularly update your password for better security
• Two-Factor Authentication (2FA): Enable 2FA for an extra layer of security
• Session Management: View and manage active sessions
• API Key Management: Generate, revoke, and manage API keys

Team Management

If you're on a team plan, you can manage team members:

1. Go to Settings > Team
2. Invite new team members by email
3. Assign roles and permissions
4. Remove team members if needed

Notification Settings

Customize your notification preferences:

• Email Notifications: Choose which emails you receive
• In-App Notifications: Configure in-app alerts
• Link Alerts: Set up alerts for specific links or thresholds

Billing

Manage your subscription, payment methods, and billing information.

Subscription Plans

ttny.io offers several subscription plans to meet your needs:

Managing Your Subscription

To manage your subscription:

1. Go to Settings > Billing
2. View your current plan and usage
3. Upgrade or downgrade your plan
4. Update payment methods
5. View billing history and download invoices

Frequently Asked Questions

Find answers to common questions about ttny.io.