Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

4.6 KB
Raw Blame
---
title: "Properties"
icon: "tags"
description: "Attach structured fields to documents, tasks, emails, and CRM records with one shared system."
---

Macro uses properties to attach structured data to any *entity* (email, task, doc, CRM record, etc.). The properties system is unified across Blocks, so you can organize different content types using the same fields, or create different fields for different content types.

<div className="prop-preview" role="img" aria-label="Task properties: Status In Progress, Priority High, Assignees Avery">
  <div className="prop-head"><span>Properties</span><svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="m9.5 6.75 5 5.25-5 5.25" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg></div>
  <div className="prop-grid">
    <span className="prop-label">Status</span>
    <span className="prop-pill"><svg className="prop-status" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path fill="currentColor" d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12V0Z" /></svg>In Progress<svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="m6.75 9.5 5.25 5 5.25-5" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg></span>
    <span className="prop-label">Priority</span>
    <span className="prop-pill"><svg className="prop-priority" width="14" height="10" viewBox="0 0 18 12" aria-hidden="true"><path d="M0 6H5V12H0.75C0.34 12 0 11.66 0 11.25V6Z" fill="currentColor" /><path d="M11.5 3H6.5V12H11.5V3Z" fill="currentColor" /><path d="M13 0H17.25C17.66 0 18 0.33 18 0.75V12H13V0Z" fill="currentColor" /></svg>High<svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="m6.75 9.5 5.25 5 5.25-5" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg></span>
    <span className="prop-label">Assignees</span>
    <span className="prop-pill"><span className="prop-avatar">A</span>Avery<svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="m6.75 9.5 5.25 5 5.25-5" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg></span>
  </div>
  <span className="prop-add"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="M12 5v14M5 12h14" stroke="currentColor" strokeWidth="2" strokeLinecap="round" /></svg>Add property</span>
</div>

On tasks, the default properties of Status, Priority, and Assignees are visible to the right of the task. To add additional properties click `Add property`.

## Supported types

**Add property** offers:

- **Input**
- **Input (Number)**
- **Checkbox**
- **Date**
- **Time range**
- **Link**
- **Option**
- **Option (Number)**
- **User**, **Document**, **Channel**, **Project**, **Chat**, **Task**, or **Email**
- **Any Entity**

**Link**, **Option**, **Option (Number)**, and those entity types can be **Single** or **Multi**.

## System vs. custom

A property is either **system** (built in and non-removable, like a task's Status) or **custom** (something you add).

## Pinned properties

You can pin properties to show them in the card on the right, or in the unified list. If a property is more like hidden metadata that you don't need to see, leave it hidden. Otherwise, pin it. Each block type has its own defaults. For example, tasks pin **Status**, **Priority**, and **Assignees** out of the box.

## Built-in fields by block

Some blocks ship with their own system properties:

- **Tasks**: Status, Priority, Assignees, Due Date, Parent Task / Subtasks, Depends On, Effort, Story Points, and Relevant Docs. See [Tasks](/product/tasks).
- **Documents**: Owner, Folder, Created and Updated timestamps, plus assignable fields like a linked Task and urgency. See [Documents](/product/docs).
- **CRM companies (Customers)**: Stage (Lead, Qualified, Demo, Trial, Negotiation, Customer, Churned), Owner (a person on your team), and Revenue, plus a Last Interaction timestamp that updates automatically from synced workspace emails.
- **CRM contacts & companies**: Email, Name, Company, interaction timestamps, Domains, Email Sync, and more.

## Agent access

Agents read and write properties through the MCP entity tools: `GetEntityProperties` to read, `SetEntityProperty` to update (status, assignee, dates, custom fields), and `ListEntities` to browse. See the [tool reference](/AI/mcp/tools/index).