Skip to main content

max / makenotwork

4.2 KB · 94 lines History Blame Raw
1 # Metadata & SEO
2
3 Metadata is what people see before they hear your music or read your work. It's the title in a search result, the image in a Discord embed, the description in a podcast app.
4
5 ## Why It Matters
6
7 When someone pastes your link into a group chat, three things appear: a title, a description, and an image. If any are missing or generic, the link looks like spam. If they're filled in, it looks like something worth clicking.
8
9 The same applies to search engines. A descriptive title and real description mean your content can be found by people searching for your kind of work.
10
11 ## Item Metadata
12
13 ### Required
14
15 - **Title**: The name of this piece. Make it specific. "Track 01" doesn't help anyone find you; "Rainfall at 3AM" does.
16
17 ### Recommended
18
19 - **Description**: Context, credits, notes (supports markdown). Appears on the item page, in search results, and in social media previews.
20 - **Tags**: Hierarchical organization for browsing and search. See [Tagging System]./tags.md.
21 - **Cover art**: Shows up in social previews, RSS readers, and podcast apps. Without it, shared links look incomplete.
22
23 ### Optional
24
25 - **Release date**: When it was or will be released. Future dates work for pre-announcements.
26 - **Credits**: Collaborators, producers, engineers. Linked to their profiles if they're on the platform.
27 - **Lyrics / transcript**: For audio and video items. Helps with accessibility and search.
28 - **Duration**: Auto-detected for audio and video. Override if the detection is wrong.
29
30 ## Project Metadata
31
32 Projects (albums, series, collections) have their own metadata separate from individual items:
33
34 - **Title**: Album or collection name
35 - **Description**: What this collection is about
36 - **Cover art**: Project-level artwork (shared by items that don't have their own)
37 - **Release date**: For the project as a whole
38 - **Item ordering**: Track or chapter order within the project
39
40 ## Audio Auto-Extraction
41
42 When you upload audio files (MP3, FLAC, M4A, WAV), we read the embedded metadata automatically:
43
44 | What we extract | Source tags |
45 |----------------|------------|
46 | Title | ID3 TIT2 / Vorbis TITLE |
47 | Artist | ID3 TPE1 / Vorbis ARTIST |
48 | Album | ID3 TALB / Vorbis ALBUM |
49 | Track number | ID3 TRCK / Vorbis TRACKNUMBER |
50 | Year | ID3 TDRC / Vorbis DATE |
51 | Genre | ID3 TCON / Vorbis GENRE |
52 | Cover art | ID3 APIC / Vorbis METADATA_BLOCK_PICTURE |
53
54 You can override any extracted value after upload. If your files have good tags already, most metadata fills itself in.
55
56 **What we don't extract:** Lyrics, credits, custom fields. Add these manually through the item editor.
57
58 ## Social Media Previews
59
60 When someone shares your link on Discord, Twitter, Mastodon, or any platform that supports Open Graph tags, they see:
61
62 - **Title**: Your item or project title
63 - **Description**: First 160 characters of your description
64 - **Image**: Your cover art, sized for social display
65 - **Player embed**: For audio and video items, platforms with Open Graph player support (Discord, Slack, Twitter) show an inline player
66
67 ### Checking Your Previews
68
69 Paste your published item URL into a group chat or social media post (you can delete it after). If the image is missing or the description is blank, go back and fill those in.
70
71 ## Search Engine Optimization
72
73 We handle the technical SEO automatically:
74
75 - **Page titles** follow the pattern: `Item Title - Creator Name | Makenot.work`
76 - **Meta descriptions** use the first 160 characters of your description, or an auto-generated summary
77 - **Structured data** (JSON-LD) tells search engines this is a product with pricing, enabling rich results
78 - **Canonical URLs** prevent duplicate content issues
79 - **Sitemap** updated automatically when you publish
80
81 ### What You Control
82
83 The two things that matter most for discoverability are your **title** and **description**. Use words that someone searching for your kind of work would actually type.
84
85 **Weak:** "New Release". Matches nothing specific.
86
87 **Better:** "Ambient Techno EP: Four Tracks, Berlin 2026". Matches genre, format, location, year.
88
89 ## See Also
90
91 - [Audio Hosting]./audio.md: File formats and metadata auto-extraction
92 - [Tagging System]./tags.md: Hierarchical tag structure and best practices
93 - [Items]./items.md: Items, projects, and organization
94