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

# Overview

> Step-by-step guide to creating text, file, and URL items

## Overview

Knowledge base items can be created in three ways:

* **Text Items**: Direct text input
* **File Items**: Upload documents
* **URL Items**: Import web content

<Info>
  All items are processed automatically after creation. Processing time varies by type: Text (instant), URL (depends on content and nested links), Files (depends on the uploaded file).
</Info>

## Choose Your Item Type

Select the type of item you want to create:

<CardGroup cols={3}>
  <Card title="Text Items" href="./creating-items/text-items">
    Create items by entering text content directly into the platform. Perfect for FAQs, policies, and quick reference materials.
  </Card>

  <Card title="File Items" href="./creating-items/file-items">
    Upload documents like PDFs, Word files, and other supported formats. Ideal for manuals, documentation, and comprehensive guides.
  </Card>

  <Card title="URL Items" href="./creating-items/url-items">
    Import content from web pages and sitemaps. Great for online documentation, product pages, and frequently updated content.
  </Card>
</CardGroup>

## Draft Management

The system automatically saves drafts as you work:

### Auto-Save Features

* **Local Storage**: Drafts saved to browser localStorage
* **Persist Across Sessions**: Drafts survive browser close
* **Separate Drafts**: One draft per item type (Text, File, URL)
* **Warning on Navigation**: Alert before leaving with unsaved changes

### Draft Indicators

When you return to create an item:

* Badge shows **"Continue with saved draft"**
* Draft description shows what's ready
* One-click resume of previous work

### Draft Lifecycle

1. **Start Creation**: Begin adding an item
2. **Fill Form**: Enter name, content, files, or URLs
3. **Navigate Away**: Draft automatically saved
4. **Return Later**: Draft loads automatically
5. **Complete and Save**: Draft removed after successful creation

<Tip>
  Use drafts to work on multiple items over time. Your progress is always saved automatically.
</Tip>

## Validation and Error Handling

### Inline Validation

The system validates input in real-time:

**Text Items:**

* Name length (1-100 characters)
* Content length (50-5,000 characters)
* Whitespace checks

**File Items:**

* File size (max 21MB)
* File format (supported extensions)
* File name length (1-100 characters)

**URL Items:**

* URL format (must be HTTPS)
* Domain validation
* Media URL detection

### Error Messages

Common validation errors:

* **"Name is required"**: Name field is empty
* **"Name must be 1-100 characters"**: Name too short or long
* **"Content must be at least 50 characters"**: Text content too short
* **"Content cannot exceed 5,000 characters"**: Text content too long
* **"File size exceeds 21MB"**: File too large
* **"Invalid URL format"**: URL doesn't start with https\://
* **"Media URLs are not supported"**: URL points to media file

### Toast Notifications

Success and error messages appear as toast notifications:

* **Success**: "Item created successfully"
* **Error**: Specific error message with details
* **Processing**: "Item is being processed"

## Storage Quota Management

### Visual Storage Display

The system displays:

* Current storage usage
* Storage limit for your plan
* Visual progress indicator
* Percentage used

### Quota Enforcement

When you reach your storage limit:

* **Add buttons disabled**: Cannot create new items
* **Clear messaging**: Shows why buttons are disabled
* **Upgrade prompt**: Suggests upgrading plan

### Plan Limits

| Plan       | Storage Limit |
| ---------- | ------------- |
| Free       | 1 MB          |
| Starter    | 5 MB          |
| Creator    | 10 MB         |
| Pro        | 50 MB         |
| Business   | 100 MB        |
| Enterprise | Custom        |

<Warning>
  Storage limits apply to the total size of all knowledge base items. Delete unused items or upgrade your plan to add more content.
</Warning>

## Next Steps

After creating items:

1. **[Monitor Processing Status](./status-lifecycle)** - Track item processing
2. **[Manage Items](./managing-items)** - Organize and filter your knowledge base
3. **[Add to Agents](../single-prompt/configure-settings)** - Use items in your agents
4. **[Review Best Practices](./best-practices)** - Optimize your knowledge base

## Related Documentation

<CardGroup cols={2}>
  <Card title="Text Items" href="./creating-items/text-items">
    Step-by-step guide for creating text items
  </Card>

  <Card title="File Items" href="./creating-items/file-items">
    Step-by-step guide for uploading documents
  </Card>

  <Card title="URL Items" href="./creating-items/url-items">
    Step-by-step guide for importing URLs
  </Card>

  <Card title="Managing Items" href="./managing-items">
    Learn how to organize and filter your knowledge base
  </Card>

  <Card title="Status Lifecycle" href="./status-lifecycle">
    Understand processing states and error handling
  </Card>

  <Card title="Best Practices" href="./best-practices">
    Optimize your knowledge base for best results
  </Card>
</CardGroup>