API access (Premium)

API access is available for Premium and Enterprise plans. Use API keys to authenticate and integrate Typink with your workflows.

Board templates

Save any board as a template to reuse structure, drawings, grid settings, and page size. You can keep templates private or share them publicly.

• Create a template from a board via “Save as template”.
• Templates preserve content, drawings, grid settings, page color, and page size.
• Use templates when creating new boards from the dashboard.

Naming templates

Naming templates automatically generate board names when you create a new board. This feature is available on Premium plans.

Template placeholders

Placeholders inside board templates expand to date, time, and user values when you create a new board from a template.

# Template Placeholders

Template placeholders allow you to create dynamic content that automatically updates when creating a new board from a template. Simply include these placeholders in your template text, and they will be replaced with current values when the board is created.

## Date Formats

### Standard Date Formats

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{today_yyyy/mm/dd}` | 2025/10/17 | Year/Month/Day with slashes |
| `{today_yyyy-mm-dd}` | 2025-10-17 | Year-Month-Day with dashes (ISO format) |
| `{today_mm/dd/yyyy}` | 10/17/2025 | Month/Day/Year (US format) |
| `{today_mm-dd-yyyy}` | 10-17-2025 | Month-Day-Year with dashes |
| `{today_dd/mm/yyyy}` | 17/10/2025 | Day/Month/Year (European format) |
| `{today_dd-mm-yyyy}` | 17-10-2025 | Day-Month-Year with dashes |
| `{today_yyyy.mm.dd}` | 2025.10.17 | Year.Month.Day with dots |
| `{today_dd.mm.yyyy}` | 17.10.2025 | Day.Month.Year with dots |

### Long Date Formats

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{today_full}` | Thursday, October 17, 2025 | Full date with weekday |
| `{today_long}` | October 17, 2025 | Long date without weekday |
| `{today_short}` | Oct 17, 2025 | Short date with abbreviated month |

## Time Formats

### 24-Hour Time

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{time_24h}` | 14:30 | 24-hour time (hours:minutes) |
| `{time_hh:mm}` | 14:30 | Same as time_24h |
| `{time_hh:mm:ss}` | 14:30:45 | 24-hour time with seconds |

### 12-Hour Time

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{time_12h}` | 2:30 PM | 12-hour time with AM/PM |
| `{time_12h_full}` | 2:30:45 PM | 12-hour time with seconds and AM/PM |

## Combined Date & Time

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{datetime}` | Oct 17, 2025, 2:30 PM | Short date with 12-hour time |
| `{datetime_full}` | Thursday, October 17, 2025, 2:30 PM | Full date with time |
| `{datetime_24h}` | 2025-10-17 14:30:45 | ISO-style datetime |

## Individual Date Components

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{year}` | 2025 | Four-digit year |
| `{month}` | 10 | Two-digit month (01-12) |
| `{day}` | 17 | Two-digit day (01-31) |
| `{month_name}` | October | Full month name |
| `{month_short}` | Oct | Abbreviated month name |
| `{day_name}` | Thursday | Full day name |
| `{day_short}` | Thu | Abbreviated day name |

## Individual Time Components

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{hour}` | 14 | Hour without leading zero (0-23) |
| `{hour_padded}` | 14 | Hour with leading zero (00-23) |
| `{hour_12}` | 2 | Hour in 12-hour format (1-12) |
| `{minute}` | 30 | Minutes with leading zero (00-59) |
| `{second}` | 45 | Seconds with leading zero (00-59) |
| `{am_pm}` | PM | Uppercase AM/PM indicator |
| `{am_pm_lower}` | pm | Lowercase am/pm indicator |

## User Information

| Placeholder | Example Output | Description |
|------------|---------------|-------------|
| `{user.name}` | John Doe | Name of the user creating the board |
| `{user.email}` | john@example.com | Email of the user creating the board |

## Usage Examples

### Meeting Notes Template

```
# Meeting Notes - {today_long}

Date: {today_yyyy/mm/dd}
Time: {time_12h}
Attendees: {user.name}

## Agenda

## Discussion

## Action Items
```

When created on October 17, 2025 at 2:30 PM by John Doe, this becomes:

```
# Meeting Notes - October 17, 2025

Date: 2025/10/17
Time: 2:30 PM
Attendees: John Doe

## Agenda

## Discussion

## Action Items
```

### Daily Journal Template

```
# Daily Journal - {day_name}, {today_short}

Created by: {user.name}
Time: {time_12h}

## Today's Goals

## Notes

## Reflections
```

### Project Planning Template

```
# Project Plan
Started: {datetime}
By: {user.name} ({user.email})

## Overview

## Timeline
Week of {today_mm/dd/yyyy}

## Tasks
```

## Technical Details

### Processing

- Placeholders are replaced when a board is created from a template
- Placeholders use the server's current date/time at the moment of board creation
- All text fields in both content and drawing data are processed
- Placeholders are case-sensitive and must be written exactly as shown
- Unknown placeholders are left unchanged

### Field Support

Placeholders are automatically replaced in:
- TipTap editor text content
- Drawing canvas text objects
- Any field with keys: `text`, `content`, `title`, or `description`

### Timezone

All date and time values use the server's timezone. For consistent results, ensure your server is configured with the correct timezone.

## Tips

1. **Test Your Templates**: Create a test board from your template to verify placeholders work as expected
2. **Combine Placeholders**: You can use multiple placeholders in the same text
3. **Formatting**: Choose date/time formats that match your regional preferences
4. **User Context**: User placeholders are populated from the authenticated user creating the board
5. **Static After Creation**: Once replaced, values become static text and don't update automatically

## Future Enhancements

Planned placeholder support:
- Custom date offsets (e.g., `{tomorrow}`, `{next_week}`)
- Week numbers and quarters
- Timezone support
- Custom date format strings
- Board metadata (board name, template name, etc.)