What are attributes?
Attributes are fields you define to store structured data about contacts and conversations. Once created here in Settings, they’re available throughout Swiftsell — in automation flows, campaign templates, audience filters, and voice agent tools.
See Contact Attributes for a full explanation of how attributes work across the platform.
Creating an attribute
- Go to Settings → Attributes.
- Click New Attribute.
- Fill in:
- Name — a human-readable label (e.g., “Company Size”)
- Key — the variable name used in templates and flows (auto-generated from the name, e.g.,
company_size)
- Type — Text, Number, Boolean, or Date
- Scope — Contact (persists across conversations) or Conversation (resets per conversation)
- Click Save.
The key is used when referencing the attribute in message templates ({{company_size}}), Collect Input blocks, and API calls. Choose a clear, lowercase snake_case key and don’t change it after creation — existing references in flows and templates will break.
Attribute types
| Type | Use for | Example values |
|---|
| Text | Names, IDs, categories, free-form text | "premium", "ORD-12345" |
| Number | Quantities, scores, ages | 42, 1500 |
| Boolean | True/false flags | true, false |
| Date | Timestamps, birthdays, deadlines | 2026-03-21 |
Editing an attribute
You can edit the name and description of an attribute after creation. You cannot change the key or type — to change these, delete the attribute and create a new one.
Deleting an attribute
- Click the … menu next to the attribute.
- Select Delete and confirm.
Deleting an attribute removes all stored values for that attribute across all contacts. This cannot be undone. Any automation blocks or templates that reference the attribute key will stop working.
System attributes
In addition to custom attributes, every contact has built-in system attributes that Swiftsell manages automatically:
| Attribute | Description |
|---|
phone | Contact’s phone number |
name | Contact’s display name |
created_at | When the contact was created |
country | Auto-detected from phone number |
Related pages
