> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-capy-add-llmstxt-summary-and.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizing for your use case

> Configure Supermemory's behavior for your specific application

Configure how Supermemory processes and retrieves content for your specific use case.

## Filter prompts

Tell Supermemory what content matters during ingestion. This helps filter and prioritize what gets indexed.

```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
// Example: Brand guidelines assistant
await client.settings.update({
  shouldLLMFilter: true,
  filterPrompt: `You are ingesting content for Brand.ai's brand guidelines system.

    Index:
    - Official brand values and mission statements
    - Approved tone of voice guidelines
    - Logo usage and visual identity docs
    - Approved messaging and taglines

    Skip:
    - Draft documents and work-in-progress
    - Outdated brand materials (pre-2024)
    - Internal discussions about brand changes
    - Competitor analysis docs`
});
```

<AccordionGroup>
  <Accordion title="Personal assistant">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Personal AI assistant. Prioritize recent content, action items,
    and personal context. Exclude spam and duplicates.`
    ```
  </Accordion>

  <Accordion title="Customer support">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Customer support agent. Prioritize verified solutions, official docs,
    and resolved tickets. Exclude internal discussions and PII.`
    ```
  </Accordion>

  <Accordion title="Legal assistant">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Legal research assistant. Prioritize precedents, current regulations,
    and approved contract language. Exclude privileged communications.`
    ```
  </Accordion>

  <Accordion title="Finance agent">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Financial analysis assistant. Prioritize latest reports, verified data,
    and regulatory filings. Exclude speculative data and MNPI.`
    ```
  </Accordion>

  <Accordion title="Healthcare">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Healthcare information assistant. Prioritize evidence-based guidelines
    and FDA-approved info. Exclude PHI and outdated recommendations.`
    ```
  </Accordion>

  <Accordion title="Developer docs">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    filterPrompt: `Developer documentation assistant. Prioritize current APIs, working
    examples, and best practices. Exclude deprecated APIs and test fixtures.`
    ```
  </Accordion>
</AccordionGroup>

### Related settings

`shouldLLMFilter` must be `true` for any of these to take effect — using them without it returns a 400 error.

| Setting | Type | Limits |
| - | - | - |
| `categories` | `string[]` | 1-50 chars each. If omitted, 3-5 categories are auto-generated |
| `includeItems` / `excludeItems` | `string[]` | 1-20 chars each item |
| `filterPrompt` | `string` | 1-750 characters |

***

## Entity context

Guide memory extraction for a specific container tag. Filter prompts are org-wide; entity context is per container.

```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
await client.add({
  content: "User asked about logo variations for dark backgrounds...",
  containerTag: "session_abc123",
  entityContext: `Design exploration conversation between john@acme.com and Brand.ai assistant.
    Focus on John's design preferences and brand requirements.`
});
```

<Accordion title="Update entity context only">
  Update entity context for a container tag without uploading content.

  ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  await client.containerTags.update("session_abc123", {
    entityContext: `Design exploration conversation between john@acme.com and Brand.ai assistant.
      Focus on John's design preferences and brand requirements.`
  });
  ```
</Accordion>

<Note>
  Entity context persists on the container tag and combines with org-level filter prompts.
</Note>

***

## Chunk size

Control how documents are split into searchable pieces. Smaller chunks = more precise retrieval but less context per result.

```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
await client.settings.update({
  chunkSize: 512  // -1 for default
});
```

| Use Case | Chunk Size | Why |
| - | - | - |
| Citations & references | `256-512` | Precise source attribution |
| Q\&A / Support | `512-1024` | Balanced context |
| Long-form analysis | `1024-2048` | More context per chunk |
| Default | `-1` | Supermemory's optimized default |

<Note>
  Smaller chunks generate more memories per document. Larger chunks provide more context but may reduce precision.
</Note>

***

## Connector branding

Show "Log in to **YourApp**" instead of "Log in to Supermemory" when users connect external services. See [Connectors Overview](/connectors/overview) for the full list of supported integrations.

<AccordionGroup>
  <Accordion title="Google Drive">
    1. Create OAuth credentials in [Google Cloud Console](https://console.cloud.google.com/)
    2. Redirect URI: `https://api.supermemory.ai/v3/connections/google-drive/callback`

    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    await client.settings.update({
      googleDriveCustomKeyEnabled: true,
      googleDriveClientId: "your-client-id.apps.googleusercontent.com",
      googleDriveClientSecret: "your-client-secret"
    });
    ```
  </Accordion>

  <Accordion title="Notion">
    1. Create integration at [Notion Developers](https://developers.notion.com/)
    2. Redirect URI: `https://api.supermemory.ai/v3/connections/notion/callback`

    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    await client.settings.update({
      notionCustomKeyEnabled: true,
      notionClientId: "your-notion-client-id",
      notionClientSecret: "your-notion-client-secret"
    });
    ```
  </Accordion>

  <Accordion title="OneDrive">
    1. Register app in [Azure Portal](https://portal.azure.com/)
    2. Redirect URI: `https://api.supermemory.ai/v3/connections/onedrive/callback`

    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    await client.settings.update({
      onedriveCustomKeyEnabled: true,
      onedriveClientId: "your-azure-app-id",
      onedriveClientSecret: "your-azure-client-secret"
    });
    ```
  </Accordion>
</AccordionGroup>

***

## API reference

```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
// Get current settings
const settings = await client.settings.get();

// Update settings
await client.settings.update({
  shouldLLMFilter: true,
  filterPrompt: "...",
  chunkSize: 512
});
```

<Note>
  Settings are organization-wide. Changes apply to new content only—existing memories aren't reprocessed.
</Note>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Add memories" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/plus-sign.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=e61184a2a5a45db092cdb1945c0c97c0" href="/ingestion/add-memories" width="24" height="24" data-path="icons/hugeicons/plus-sign.svg">
    See your custom settings in action
  </Card>

  <Card title="Connectors" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/plug-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=5cf60fb59d4d0eccb55e5d078d0f52cf" href="/connectors/overview" width="24" height="24" data-path="icons/hugeicons/plug-01.svg">
    Set up automatic syncing from external platforms
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.