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

# Memory Buckets

> Organize your memories into separate contexts with MemoryPlugin's bucket system

export const ArticleInfo = ({author, lastUpdated}) => {
  const authorAvatar = author === 'asad' ? '/images/author-asad.jpeg' : null;
  const formatDate = dateInput => {
    if (!dateInput) return '';
    if (typeof dateInput === 'string' && !dateInput.match(/^\d{4}-\d{2}-\d{2}/)) {
      return dateInput;
    }
    try {
      const date = new Date(dateInput);
      const now = new Date();
      const diffTime = Math.abs(now - date);
      const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
      if (diffDays === 0) return 'today';
      if (diffDays === 1) return '1 day ago';
      if (diffDays < 7) return `${diffDays} days ago`;
      if (diffDays < 30) return `${Math.ceil(diffDays / 7)} week${Math.ceil(diffDays / 7) > 1 ? 's' : ''} ago`;
      if (diffDays < 365) return `${Math.ceil(diffDays / 30)} month${Math.ceil(diffDays / 30) > 1 ? 's' : ''} ago`;
      return `${Math.ceil(diffDays / 365)} year${Math.ceil(diffDays / 365) > 1 ? 's' : ''} ago`;
    } catch {
      return dateInput;
    }
  };
  return <div style={{
    display: "flex",
    alignItems: "center",
    gap: "8px",
    marginBottom: "16px",
    padding: "8px 12px",
    backgroundColor: "var(--ifm-color-emphasis-100)",
    borderRadius: "6px",
    fontSize: "14px",
    color: "var(--ifm-color-content-secondary)",
    border: "1px solid var(--ifm-color-emphasis-200)",
    opacity: "0.8"
  }}>
      <div style={{
    width: "40px",
    height: "40px",
    borderRadius: "50%",
    background: authorAvatar || "linear-gradient(45deg, #4F46E5, #7C3AED)",
    display: "flex",
    alignItems: "center",
    justifyContent: "center",
    color: "white",
    fontWeight: "bold",
    fontSize: "18px"
  }}>
        {authorAvatar ? <img src={authorAvatar} alt={author} style={{
    width: "100%",
    height: "100%",
    borderRadius: "50%"
  }} /> : author?.[0]?.toUpperCase()}
      </div>
      <div>
        <div style={{
    fontWeight: "400",
    fontSize: "14px"
  }}>Written by <span style={{
    fontWeight: "600"
  }}>{author}</span></div>
        <div style={{
    fontSize: "14px"
  }}>Last updated <span style={{
    fontWeight: "600"
  }}>{formatDate(lastUpdated)}</span></div>
      </div>
    </div>;
};

<ArticleInfo author="asad" lastUpdated="2026-03-23" />

Memory Buckets are an organizational system that lets you group related memories together into separate, isolated collections. Think of them as folders for your memories.

## What are Memory Buckets?

Buckets let you organize your memories into completely separate contexts. Each bucket is isolated from others, so your work memories stay separate from personal ones, and project-specific information doesn't mix with general notes.

**Perfect for organizing by:**

* **Context**: Personal vs. Work vs. Hobbies
* **Projects**: Different client work or personal projects
* **Topics**: Learning materials, research, creative ideas
* **Time periods**: Quarterly goals, event planning

<Info>
  Every account starts with a **"General"** bucket where all memories go by default. This bucket cannot be deleted, ensuring you always have a place for new memories.
</Info>

## Creating a New Bucket

Creating buckets is straightforward:

1. **Open your [MemoryPlugin Dashboard](https://memoryplugin.com/dashboard)**
2. **Click the "New Bucket" button**
3. **Give your bucket a descriptive name**
4. **Click "Create" and you're done!**

<img src="https://mintcdn.com/memoryplugin/7JRbRjKuQWC5r5_N/images/memory-buckets/create-bucket.png?fit=max&auto=format&n=7JRbRjKuQWC5r5_N&q=85&s=805dcc6ca82a7c86003c49e33aa8356c" alt="Creating a new memory bucket in the dashboard" width="1612" height="288" data-path="images/memory-buckets/create-bucket.png" />

<Note>
  **Naming requirements**:

  * Bucket names must be unique (case-insensitive — "Work" and "work" are considered the same name)
  * Bucket names cannot be numbers alone (like "123"). You can include numbers in your bucket name, but it needs other characters too (like "Project 123" or "Q1 Goals").
</Note>

## Using Buckets

### With Browser Extension

When using the browser extension, you can switch between buckets using the MemoryPlugin interface. Click the MemoryPlugin button to see your buckets and select which one to use for the current conversation.

### With MCP Server

Specify which bucket to load memories from in your MCP client configuration or during conversations by asking the AI to load memories from a specific bucket.

### With Custom GPT

You can ask the MemoryPlugin Custom GPT to work with specific buckets:

* "Load memories from my Work bucket"
* "Store this in my Personal bucket"
* "Use Project A bucket for this chat" (to load and add memories to that bucket by default)

## Benefits of Using Buckets

<CardGroup cols={2}>
  <Card title="Context Separation" icon="layer-group">
    Keep work and personal memories completely separate
  </Card>

  <Card title="Project Organization" icon="folder-tree">
    Organize memories by project, client, or topic
  </Card>

  <Card title="Focused Loading" icon="bullseye">
    Load only relevant memories for better AI performance
  </Card>

  <Card title="Custom Ordering" icon="arrows-up-down">
    Drag and drop buckets to reorder them to your preference
  </Card>
</CardGroup>

## Are there any limits on buckets?

### Bucket Creation

There are no limits on the number of buckets you can create. You can create as many buckets as you need to organize your memories effectively.

### Feature Limitations

Some advanced features have requirements or limits based on your bucket's size:

**Minimum Requirements:**

* **Smart Memory Categories**: Requires at least 30 memories in a bucket to generate meaningful category groupings

**Maximum Limits:**

* **Smart Memory Categories**: Won't process buckets larger than 600,000 tokens or 2,000 memories (for performance)
* **Memory Suggestions**: Automatically skips individual memories with >10,000 tokens during analysis

**Context Window Limits:**
The dashboard shows how your bucket size compares to different AI model limits:

* ChatGPT (GPT-4o): 32,000 tokens
* ChatGPT (thinking models): \~200,000 tokens
* Claude: 200,000 tokens
* Gemini: 1,000,000 tokens

These limitations help ensure optimal performance and meaningful results from AI-powered features.

## Managing Buckets

### Viewing Buckets

All your buckets are visible in the MemoryPlugin Dashboard where you can:

* See bucket names and memory counts
* Access memories within each bucket
* Switch between buckets easily
* Drag and drop buckets to reorder them

### Moving Memories

You can move memories between buckets using:

* The dashboard interface
* [Bulk operations](/features/bulk-operations) for multiple memories
* API calls for programmatic management

### Deleting Buckets

You can delete buckets you no longer need, with these restrictions:

* The "General" bucket cannot be deleted
* Deleting a bucket will also delete all memories within it
* This action cannot be undone, so be careful!

## Best Practices

<AccordionGroup>
  <Accordion title="Naming Convention">
    Use clear, descriptive names that will make sense to you months later. Consider using prefixes like "Project-", "Client-", or "Personal-" for consistency.
  </Accordion>

  <Accordion title="Bucket Strategy">
    Plan your bucket structure before creating many memories. Consider how you work and what contexts you need to keep separate.
  </Accordion>

  <Accordion title="Regular Review">
    Periodically review your buckets and memories to ensure they're still organized in a way that serves your needs.
  </Accordion>
</AccordionGroup>

## Example Bucket Structures

### Freelancer/Consultant

* `General` (default)
* `Client-Acme Corp`
* `Client-Beta LLC`
* `Personal Projects`
* `Learning & Development`

### Software Developer

* `General` (default)
* `Project-WebApp`
* `Project-MobileApp`
* `Technical Research`
* `Work Notes`
* `Personal Coding`

### Content Creator

* `General` (default)
* `YouTube Channel`
* `Blog Content`
* `Client Work`
* `Research & Ideas`
* `Personal Brand`

## Integration with Other Features

### Smart Memory

[Smart Memory](/features/smart-memory) works at the bucket level, creating high-level overviews of memories within each bucket for more efficient AI interactions.

### Bulk Operations

Use [bulk operations](/features/bulk-operations) to move multiple memories between buckets or perform actions on entire bucket contents.

## Next Steps

<CardGroup cols={2}>
  <Card title="Smart Memory" icon="brain" href="/features/smart-memory">
    Learn how Smart Memory optimizes bucket performance
  </Card>

  <Card title="Bulk Operations" icon="list" href="/features/bulk-operations">
    Manage multiple memories and buckets efficiently
  </Card>
</CardGroup>