API access (Premium)

API access is available on the Premium plan. Use API keys to authenticate and integrate Typink with your own tools and workflows.

Board templates

Save any board as a template to reuse its structure, drawings, grid settings, and page size. Templates can be kept private or shared 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 the Premium plan.

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.)