# Items

Items are individual pieces of content: a song, an article, a software release, a sample pack, a course module. Every item belongs to a project.

---

## Item Types

| Type | Content | Player/Viewer | Chapters | Versions |
|------|---------|--------------|----------|----------|
| **Audio** | MP3, WAV, FLAC, OGG, AAC, AIFF | In-browser streaming player | Yes | Yes |
| **Text** | Markdown | Clean reading view | No | No |
| **Digital** | Any file (ZIP, DMG, EXE, PDF, etc.) | Download link | No | Yes |
| **Video** | Video files | In-browser video player | No | Yes |
| **Image** | Image files | Gallery view | No | No |
| **Plugin** | Audio plugins (VST, AU, CLAP) | Download link | No | Yes |
| **Preset** | Presets and patches | Download link | No | Yes |
| **Sample** | Sample packs | Download link | No | Yes |
| **Course** | Educational content | Course viewer | No | Yes |
| **Template** | Templates and themes | Download link | No | Yes |
| **Bundle** | Collection of other items | Combined listing | No | No |

Choose the type when creating the item. It cannot be changed afterward.

## Creating an Item

1. Navigate to your project
2. Click **New Item**
3. Set a **title** and **item type**
4. Optionally set a price (defaults to free)

## Editing an Item

From the item settings, update:

- **Title**: Display name
- **Description**: Shown on the item page (markdown supported)
- **Price**: Free, fixed amount, or pay-what-you-want
- **Tags**: Hierarchical tags for discovery
- **Cover image**: Displayed on the item card and in social previews
- **Release date**: When it was or will be released
- **Credits**: Collaborators, producers, engineers
- **AI tier**: Handmade, Assisted (with disclosure statement), or Generated. Required before publishing. See [Generative AI Policy](../about/generative-ai.md)

## Item URLs

Every item gets a permanent link:

```
makenot.work/i/uuid
```

This URL never changes, even if you rename the item or move it to a different project.

## Publishing Workflow

Items start as **drafts**, visible only to you.

### Publishing

1. Edit the item and switch on **Public**
2. Make sure the parent project is also public

Published items appear on your profile, in search results, and in RSS feeds.

### Scheduling

Set a future publish date to schedule content releases. The item becomes visible automatically at the scheduled time.

### Unpublishing

Unpublish anytime to revert an item to draft. All settings and data are retained.

## Bulk Operations

From the project dashboard, select multiple items to:

- **Publish**: Make multiple items public at once
- **Unpublish**: Revert multiple items to draft
- **Delete**: Remove multiple items permanently

## Reordering

Drag to reorder items within a project. The order you set is the order fans see on the project page.

## Duplicating

Duplicate an item to create a copy with the same settings and metadata. Content (files, text) is not duplicated.

## Versions

Track releases with version numbers and changelogs. Available for audio and digital items.

### Creating a Version

- **Version number** (required): Any string up to 50 characters (e.g., `1.0.0`, `v2`, `2024-03-01`)
- **Changelog** (optional): Up to 10,000 characters describing what changed
- **File**: Optionally attach a new file to this version

Only one version is "current" at a time, the one fans download by default. New versions automatically become current.

## Chapters

Timestamp markers for audio items. Fans can jump to specific sections within a track.

- **Title**: 1-200 characters
- **Start seconds**: Where the chapter begins (e.g., `0`, `30.5`, `125`)
- **Sort order**: Controls display order

Chapters display sorted by sort order first, then by start time.

## Dynamic Clips

Audio items support dynamic clips, reusable audio segments placed before, during, or after the main audio:

- **Pre-roll**: Plays before the main content
- **Mid-roll**: Plays at a specific timestamp
- **Post-roll**: Plays after the main content

Upload clips once and add them across multiple items. See [Dynamic Clips](./dynamic-clips.md) for the full guide.

## Cover Images

Cover images appear on item cards, in the audio player, in social media previews, and in search results.

## File Uploads

Upload files from the item's content tab. Files are stored as-is: what you upload is what fans download.

For audio, files also stream in-browser via the built-in player.

## Malware Scanning

All uploaded files are scanned for malware (ClamAV, YARA rules, hash-based lookup) before they become available for download. Failed files are quarantined and you are notified.

## License Keys

For software products, enable license keys in item settings:

- **Activation limit**: How many machines can activate a single key
- Keys are generated automatically when fans purchase
- Fans see their keys in their library
- You can revoke keys from the dashboard

See [License Key API](../developer/license-keys.md) for integration details.

## Deleting an Item

Deleting an item removes it permanently. Fans who purchased it lose access. Active download codes and license keys for the item are invalidated.

---

## See Also

- [Projects](./projects.md): Organizing items into projects
- [Content Overview](./02-content.md): Content types, versions, and chapters in detail
- [Audio Hosting](./audio.md): File formats and download process
- [Tagging System](./tags.md): Hierarchical tags for organization
- [Metadata & SEO](./metadata.md): Descriptions and discoverability