> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsnippets.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Snippet Insertion with Quick Access

> Insert snippets anywhere on your computer using Quick Access

## Overview

Snippet insertion is the core purpose of Quick Access-instantly inserting your saved snippets into any application on your computer. Whether you're writing code, composing emails, chatting in Slack, or prompting AI tools, Quick Access inserts your snippets exactly where you need them.

This guide covers everything about the insertion workflow, from basic usage to advanced techniques.

## Why Quick Access Insertion Matters

Traditional copy-paste workflows are slow and error-prone:

**Old Way:**

1. Open note-taking app
2. Search for snippet
3. Copy to clipboard
4. Switch back to original app
5. Find where you were
6. Paste

**With Quick Access:**

1. Press `Option/Ctrl + Space`
2. Type snippet name
3. Press `Enter`
4. Done in 2 seconds

This 10x speed boost compounds over hundreds of daily insertions.

## How It Works

<iframe src="https://player.vimeo.com/video/1109104999?h=0&title=0&byline=0&portrait=0&autoplay=1&muted=1" width="100%" height="450" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen />

### Basic Insertion Flow

#### 1. **Position Your Cursor**

Click or tab to position your cursor exactly where you want to insert the snippet:

* Text editor
* Email compose box
* Chat input field
* Terminal
* Any text input anywhere

#### 2. **Open Quick Access**

Press `Option + Space` (Mac) or `Ctrl + Space` (Windows/Linux).

Quick Access opens as a floating window on top of your current application.

#### 3. **Find Your Snippet**

Use any of these methods:

* **Type to search**: Start typing snippet name
* **Browse**: Scroll through your library
* **Filter by tag**: Search for `tagname`
* **Favorites**: Switch to Favorites tab
* **Recent**: Check Recently Used tab

#### 4. **Select the Snippet**

Navigate to your desired snippet:

* Use arrow keys (`↑` `↓`)
* Or click with mouse
* Preview appears showing full content

#### 5. **Insert**

Press `Enter` or click the snippet.

The snippet text is instantly inserted at your cursor position, and Quick Access closes automatically.

## Where Quick Access Works

Quick Access insertion works in **any application** that accepts text input:

### Code Editors & IDEs

* VS Code, Cursor, Neovim, Sublime Text
* JetBrains IDEs (IntelliJ, PyCharm, WebStorm)
* Xcode, Android Studio
* Online editors (CodeSandbox, StackBlitz)

### AI Tools

* ChatGPT, Claude, Perplexity
* Cursor AI, GitHub Copilot Chat
* Lovable, V0, Bolt
* Any AI tool with text input

### Communication

* Slack, Discord, Microsoft Teams
* Email (Gmail, Outlook, Superhuman)
* Zoom chat, Google Meet
* Any messaging platform

### Productivity Tools

* Notion, Obsidian, Roam
* Linear, Jira, Asana
* Google Docs, Microsoft Word
* Todoist, ClickUp

### Browsers

* Search bars
* Form fields
* Web apps
* Browser DevTools console

### Terminal

* Terminal.app, iTerm2, Hyper
* Windows Terminal, PowerShell
* Any command-line interface

### Anywhere Else

* Native macOS/Windows text inputs
* PDF annotation tools
* Design tools with text fields
* Literally any app with text input

## Advanced Insertion Techniques

### Multi-Line Snippets

Quick Access handles complex, multi-line content:

```python theme={null}
def calculate_total(items, tax_rate=0.08):
    """Calculate total with tax."""
    subtotal = sum(item['price'] for item in items)
    tax = subtotal * tax_rate
    return subtotal + tax
```

Inserts perfectly formatted with proper indentation.

### Code Blocks with Syntax

Insert code with proper formatting:

```javascript theme={null}
const apiRequest = async (endpoint) => {
	try {
		const response = await fetch(`https://api.example.com/${endpoint}`);
		return response.json();
	} catch (error) {
		console.error('API Error:', error);
		throw error;
	}
};
```

### Templates with Structure

Insert structured templates:

```markdown theme={null}
## Meeting Notes - {DATE}

**Attendees:**

- **Agenda:**

1.
2.
3.

**Action Items:**

- [ ]
- [ ]

**Next Meeting:**
```

Cursor positions naturally for you to fill in placeholders.

### Large Documents

Even large snippets insert instantly:

* Documentation templates (1000+ lines)
* Configuration files
* SQL schemas
* API response examples

## Insertion Options

### Standard Insertion (Default)

Press `Enter` - Inserts snippet and closes Quick Access.

**Best for:** Most use cases, quick insertion workflow.

### Copy Instead of Insert

Sometimes you want to copy to clipboard instead of direct insertion:

* For apps where insertion doesn't work
* To manually position the content
* To paste multiple times

**How to:** Right-click snippet → "Copy to Clipboard" (or use `Cmd/Ctrl + C` when snippet is selected).

## Insertion in Different Contexts

### Terminal Insertion

Inserting commands in terminal requires care:

```bash theme={null}
# Snippet doesn't auto-execute - you review first
docker-compose up -d && docker-compose logs -f
```

The command is inserted but **not executed** until you press Enter. This safety feature prevents accidental command execution.

### Form Fields

When inserting into web forms:

* Quick Access works in any text input or textarea
* May trigger form validation
* Works with auto-save features

## Keyboard-Only Workflow

Master Quick Access without touching the mouse:

```
1. Option/Ctrl + Space
   → Open Quick Access

2. Type search query
   → Filter snippets

3. ↑/↓ arrow keys
   → Navigate results

4. Enter
   → Insert and close

5. Continue typing
   → Keep working seamlessly
```

## Best Practices

<Tip>
  **Cursor First, Quick Access Second**: Always position your cursor before
  opening Quick Access. This ensures insertion happens exactly where you want.
</Tip>

<Tip>
  **Learn Fuzzy Search**: You don't need to type full snippet names. "dbquery"
  will find "Database Query Template".
</Tip>

<Tip>
  **Use Favorites for Speed**: Star your most-used snippets so they're one Tab
  press away in Quick Access.
</Tip>

<Tip>
  **Preview Before Inserting**: Hover or arrow-key to preview snippet content
  before inserting-prevents mistakes.
</Tip>

## Common Issues & Solutions

### Insertion Not Working

If Quick Access opens but insertion fails:

1. **Permission Issue**: Snippets AI needs Accessibility permissions

   * Mac: System Settings → Privacy & Security → Accessibility → Enable Snippets AI
   * Windows: Should work by default, check antivirus settings

2. **App Conflict**: Some apps block external input

   * Try copying to clipboard instead (`Cmd/Ctrl + C`)
   * Paste manually (`Cmd/Ctrl + V`)

3. **Focus Issue**: Cursor lost focus when Quick Access opened
   * Close Quick Access and reposition cursor
   * Try again

### Formatting Lost

If inserted snippet loses formatting:

1. **Plain Text Fields**: Some inputs only accept plain text
   * Expected behavior in terminals, search bars
2. **Rich Text Conversion**: App converts to its own format
   * May need to adjust snippet formatting
3. **Character Encoding**: Special characters not supported
   * Check snippet for unsupported characters

### Wrong Location

If snippet inserts in wrong place:

1. **Cursor Position**: Ensure cursor is visible and blinking before opening Quick Access
2. **Multiple Inputs**: If multiple text fields are visible, click the correct one first
3. **Modal Dialogs**: Some overlay dialogs may not accept Quick Access insertion

## Performance Tips

### Instant Insertion

For maximum speed:

1. Memorize your top 10 snippet names
2. Train muscle memory for the full flow: `Shortcut → Type → Enter`
3. Use single-word snippet names for frequently-used items

### Bulk Insertion

When building documents from multiple snippets:

1. Insert first snippet
2. Position cursor for next snippet
3. Quick Access → Insert next
4. Repeat

With practice, you can assemble complex documents in seconds.

## What's Next

<Card title="Quick Access Overview" icon="bolt" href="/guides/quick-access-intro">
  Learn all features of Quick Access
</Card>

<Card title="Snippet Expansion" icon="keyboard" href="/guides/snippet-expansion">
  Learn about automatic text expansion as an alternative to Quick Access
</Card>

<Card title="Quick Access with AI Tools" icon="wand-magic-sparkles" href="/guides/quick-access-ai-tools">
  See specific examples of using Quick Access with Cursor, Lovable, and more
</Card>
