Templates

Template system and variable reference for Spotify Link

Last updated: March 30, 2026

templatesvariablescustomization

Templates

Template system for customizing Spotify data insertion.

Template Types

Inline Templates

Direct string in settings:

'{{ song_name }}' by {{ artists }} from {{ album }} released in {{ album_release }}
{{ timestamp }}

File-based Templates

Reference to vault file:

Templates/Spotify/track.md

File contains same syntax as inline templates.

Variables

Track Variables

Basic Info

  • {{ song_name }} - Track title
  • {{ song_link }} - Markdown link with track name and artists
  • {{ song_url }} - Spotify URL (plain text)

Album

  • {{ album }} - Album name
  • {{ album_link }} - Markdown link to album
  • {{ album_url }} - Album Spotify URL
  • {{ album_release }} - Release date, format controlled by setting or inline override (see Date formatting)

Album Covers

  • {{ album_cover_large }} - Large cover as markdown image
  • {{ album_cover_medium }} - Medium cover as markdown image
  • {{ album_cover_small }} - Small cover as markdown image
  • {{ album_cover_link_large }} - Large cover as markdown link
  • {{ album_cover_link_medium }} - Medium cover as link
  • {{ album_cover_link_small }} - Small cover as link
  • {{ album_cover_url_large }} - Large cover URL (plain)
  • {{ album_cover_url_medium }} - Medium cover URL
  • {{ album_cover_url_small }} - Small cover URL

Image tokens accept an optional inline size override — see Image dimensions.

Artists

  • {{ artists }} - Comma-separated artist names
  • {{ artist_name }} - Same as artists
  • {{ artists_formatted:PREFIX:SUFFIX }} - Custom formatting
  • {{ main_artist_url }} - Primary artist API URL

Example formatted artists:

{{ artists_formatted:  - [[:]] }}

Output:

 - [[Artist One]]
 - [[Artist Two]]

Hashtag format:

{{ artists_formatted:#: }}

Output: #Artist_One #Artist_Two

Artist Metadata

  • {{ followers }} - Follower count (single: number, multiple: “Name: count”)
  • {{ popularity }} - Popularity score 0-100
  • {{ artist_image }} - Artist images as markdown image (accepts inline size override, see Image dimensions)
  • {{ artist_image_link }} - Artist images as markdown link (no ! prefix)
  • {{ artist_image_url }} - Artist image URLs (plain text)
  • {{ genres }} - Comma-separated genres
  • {{ genres_array }} - Quoted genre array: "genre1", "genre2"
  • {{ genres_hashtag }} - Hashtag format: #genre_one #genre_two

Playlists

  • {{ playlists }} - Comma-separated names of the user’s owned playlists that contain the current track, plus “Liked Songs” if saved. Requires playlist-read-private and user-library-read scopes (included in the default scope for new installations). Only fetched when the token is present in the template.

Performance note: The Spotify API does not provide a way to look up which playlists contain a given track. The plugin must scan each of your owned playlists individually, which can be slow depending on how many playlists you have and how many tracks they contain. The scan runs in parallel batches (configurable via the Playlist concurrency setting) to minimize wait time. A notification shows progress and reports the total time when complete.

Timestamps

  • {{ timestamp }} - Local date and time
  • {{ timestampz }} - UTC ISO format
  • {{ timestamp(YYYY-MM-DD) }} - Custom date format
  • {{ timestamp(HH:mm) }} - Custom time format
  • {{ timestamp(YYYY-MM-DD HH:mm) }} - Combined format
  • {{ timestampz(...) }} - UTC variants

Episode Variables

Basic Info

  • {{ episode_name }} - Episode title
  • {{ episode_link }} - Markdown link to episode
  • {{ episode_url }} - Episode Spotify URL (plain text)
  • {{ description }} - Full description
  • {{ description[100] }} - Truncated to 100 chars (adds ...)
  • {{ release_date }} - Release date, format controlled by setting or inline override (see Date formatting)

Episode Covers

  • {{ episode_cover_large }} - Large cover as markdown image
  • {{ episode_cover_medium }} - Medium cover as markdown image
  • {{ episode_cover_small }} - Small cover as markdown image
  • {{ episode_cover_link_large }} - Large cover as link
  • {{ episode_cover_link_medium }} - Medium cover as link
  • {{ episode_cover_link_small }} - Small cover as link
  • {{ episode_cover_url_large }} - Large cover URL (plain)
  • {{ episode_cover_url_medium }} - Medium cover URL
  • {{ episode_cover_url_small }} - Small cover URL

Image tokens accept an optional inline size override — see Image dimensions.

Show Info

  • {{ show_name }} - Podcast name
  • {{ show_link }} - Spotify URL for show
  • {{ show_description }} - Podcast description
  • {{ publisher }} - Podcast publisher
  • {{ total_episodes }} - Total episode count

Playback

  • {{ duration_ms }} - Episode duration in milliseconds
  • {{ progress_ms }} - Current position in milliseconds
  • {{ progress_sec }} - Current position in seconds
  • {{ progress_min_sec }} - Formatted as “MM:SS”
  • {{ audio_preview_url }} - Preview audio URL (if available)

Timestamps

Same format as track timestamps (see above).

Recently Played Variables

Supports all track variables plus:

  • {{ played_at }} - When track was played (YYYY-MM-DD HH:mm)

Examples

Minimal Track Template

'{{ song_name }}' by {{ artists }}
{{ timestamp }}

Detailed Track Template

**Song Name:** {{ song_name }}
**Song URL:** {{ song_link }}
**Album Name:** {{ album }}
**Album Release Date:** {{ album_release }}
**Album URL:** {{ album_link }}
**Cover:** {{ album_cover_medium }}
**Artists:** {{ artists }}
**Genres:** {{ genres_hashtag }}
**Added at:** *{{ timestamp }}*

Track with Playlists

**Song:** {{ song_name }}
**Artists:** {{ artists }}
**Playlists:** {{ playlists }}

Output: **Playlists:** My Favorites, Workout Mix, Chill Vibes

Episode Template

**Episode:** {{ episode_name }}
**Show:** {{ show_name }}
**Publisher:** {{ publisher }}
**Description:** {{ description[200] }}
**Progress:** {{ progress_min_sec }}
**Released:** {{ release_date }}
{{ timestamp }}

Recently Played Template

'{{ song_name }}' by {{ artists }} from {{ album }} @ {{ played_at }}

Dataview Integration

---
track: "{{ song_name }}"
artists: [{{ artists_formatted:":, }}]
album: "{{ album }}"
release: {{ album_release }}
genres: [{{ genres_array }}]
---

# {{ song_name }}

{{ album_cover_medium }}

**Artists:** {{ artists }}
**Genres:** {{ genres_hashtag }}

Template Processing

Variable substitution uses regex replacement:

  1. Load template (file or inline)
  2. Fetch Spotify data
  3. Replace variables with actual values
  4. Handle special cases (formatting, truncation)
  5. Return processed string

Whitespace in variable syntax is optional:

  • {{ song_name }} = {{song_name}}

Advanced Formatting

Conditional Artist Display

Single artist: followers as number
Multiple artists: “Name: count” per artist

Template automatically adapts based on artist count.

Genre Deduplication

Genres across multiple artists are deduplicated automatically.

Timestamp Formats

Combine date/time components:

{{ timestamp(YYYY-MM-DD HH:mm) }}

UTC variants with z suffix:

{{ timestampz(YYYY-MM-DD HH:mm) }}

Image Size Selection

Spotify provides three sizes (indices 0, 1, 2):

  • [0] - Large (typically 640x640)
  • [1] - Medium (typically 300x300)
  • [2] - Small (typically 64x64)

Image Dimensions

By default Obsidian renders images at full available width. You can constrain the size two ways:

Global default — set Default image size in plugin settings (e.g. 200x200). Applies to every image token unless overridden.

Inline override — append |WxH or |W directly to the token:

{{ album_cover_medium|100x100 }}
{{ album_cover_large|300 }}
{{ artist_image|50x50 }}
{{ episode_cover_medium|150x150 }}

Inline override takes precedence over the setting. The value is passed directly to Obsidian’s image syntax (![alt|WxH](url)), so any value Obsidian accepts works here.

Inside Markdown tables — | is the column separator in Markdown, so escape it with \|:

| Cover | Date |
| ----- | ---- |
| {{ album_cover_medium\|100x100 }} | {{ album_release\|YYYY }} |

The plugin detects the \| and preserves it in the generated output (![alt\|WxH](url)), keeping the table structure intact.

Note: the Global default image size setting does not carry the table context — it always outputs a bare |. If you need a sized image inside a table, use the inline \| override explicitly.

Date Formatting

{{ album_release }} (tracks) and {{ release_date }} (episodes) output Spotify’s raw date by default (YYYY-MM-DD, YYYY-MM, or YYYY depending on precision).

Global default — set Default release date format in plugin settings. Tokens: YYYY, MM, DD.

Inline override — append |FORMAT to the token:

{{ album_release|YYYY }}
{{ album_release|YYYY-MM }}
{{ album_release|MM/DD/YYYY }}
{{ release_date|YYYY }}

Inside Markdown tables — use \| instead of |:

{{ album_release\|YYYY }}
{{ release_date\|YYYY-MM }}

Inline override takes precedence over the setting. Leaving both empty preserves the original Spotify date string (fully backward compatible).

Note: date tokens produce plain text output (no | character), so the Global default date format works fine inside tables without any special handling.