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

# Memory Blocks

> Memory blocks are the core unit of Promptr: reusable AI content you create once and use everywhere.

A memory block (or simply a **memory**) is a named, reusable piece of AI content. You write it once, store it in a Space, and inject it into ChatGPT, Claude, or Gemini via the Promptr browser extension, without retyping or copy-pasting brand context, guidelines, or prompts every time.

Every memory block has a title, content, and an AI behavior mode that controls how the extension delivers it to the AI.

## Block types

Promptr's data model supports multiple block types. Currently, all memory blocks use the **Context** type. Additional types (**Instruction** and **Prompt**) are coming soon as part of upcoming AI-assisted creation features.

<Tabs>
  <Tab title="Context (available now)">
    **Context** blocks carry background information the AI needs to understand your situation: brand voice, audience details, campaign briefs, product facts, or any reference material a marketing team needs to stay consistent.

    Use a Context block when you want to give the AI relevant background without making it the focus of your message.

    **Examples:**

    * Brand voice and tone guidelines
    * Target audience personas
    * Client background and product details
    * Campaign briefs or project context

    Context blocks default to the **Attach** AI behavior, which sends the block as a separate context item alongside your message.
  </Tab>

  <Tab title="Instruction (coming soon)">
    **Instruction** blocks will contain behavioral rules: directives that shape how the AI responds throughout a conversation.

    **Examples:**

    * Writing style and format rules
    * "Always write in second person"
    * "Never suggest competitor products"

    Instruction blocks will default to the **Inject** AI behavior.
  </Tab>

  <Tab title="Prompt (coming soon)">
    **Prompt** blocks will be complete, ready-to-use prompt templates that stand alone and replace your input entirely when used.

    **Examples:**

    * A social media caption generator
    * An email campaign brief template
    * A weekly report starter

    Prompt blocks will default to the **Replace** AI behavior.
  </Tab>
</Tabs>

## Block properties

Each memory block stores the following fields:

| Property        | Description                                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Title**       | The display name you use to find and identify the block.                                                         |
| **Content**     | The actual text delivered to the AI. Supports Markdown.                                                          |
| **AI behavior** | How the extension delivers the block: `attach`, `inject`, or `replace`.                                          |
| **Description** | An optional short summary shown in the block browser to help you and your team understand what the block does.   |
| **Icon**        | An optional visual identifier. Choose an emoji, a flat icon from the built-in library, or upload a custom image. |
| **Tags**        | Workspace-level labels for filtering and organizing blocks.                                                      |

## AI behavior modes

The AI behavior setting controls exactly how the browser extension sends your memory block to the AI tool. You can override the default for any block.

<CardGroup cols={1}>
  <Card title="Attach" icon="paperclip">
    Attached as a separate context block alongside your message. This is the recommended default for most blocks, keeping your actual message clean while still providing the AI with the block's content.
  </Card>

  <Card title="Inject" icon="arrow-right-to-line">
    Injected directly into the system prompt or conversation. Best for instructions and rules that need to be woven into the prompt flow rather than presented as a separate attachment.
  </Card>

  <Card title="Replace" icon="arrows-rotate">
    Replaces your entire input with the block's content. Best for complete, self-contained prompt templates that require no additional message from you.
  </Card>
</CardGroup>

<Tip>
  If you're unsure which behavior to use, leave it set to **Attach**. It works well for the majority of blocks and keeps the interaction predictable.
</Tip>

## How blocks are organized

Memory blocks live inside [Spaces](/concepts/spaces). Every block belongs to exactly one Space, and you can move a block to a different Space at any time. Spaces let you group blocks by client, project, or team, in any structure that fits your workflow.

See [Spaces](/concepts/spaces) for details on how to organize your memory blocks.

## Usage tracking

Promptr tracks how you use your memory blocks so the most relevant content is always close at hand:

* **Recently used:** the extension surfaces blocks you've used recently so you can re-apply them quickly.
* **Usage count:** each block records how many times it has been used, giving you a signal for which blocks are delivering real value.

Both metrics are tracked per user, so your recently used list is personal to you even in a shared team Space.