Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

docs: add digital products walkthrough to product creation guide (#14202)

mintlify[bot]452004afa942
diff --git a/docs/user/products/creating-products.mdx b/docs/user/products/creating-products.mdx
index 75b134bdf6..6ff5482b40 100644
--- a/docs/user/products/creating-products.mdx
+++ b/docs/user/products/creating-products.mdx
@@ -1,6 +1,6 @@
---
title: "Create a Product"
-description: "Learn how to create a new product from scratch in Spree Commerce."
+description: "Step-by-step guide to creating a product in the Spree admin, including media, pricing, variants, inventory, shipping, and digital downloads."
---
Adding products manually is a crucial part of managing any ecommerce store. Whether you're launching something new, setting up preorders, or testing a market-specific variant, Spree makes it easy to create fully-detailed products through a clean and structured editor.
@@ -209,6 +209,42 @@ Click **Edit** to modify:
- **Meta Description:** Short summary shown beneath the title
- **Slug:** Controls the product’s URL. If not set, the product name is used (e.g., /black-hoodie)
+## Digital Products
+
+If you're selling a downloadable file (PDF, ZIP, audio, video, software, license key, etc.), configure the product as digital so the storefront can deliver the file after purchase and skip the shipping step at checkout.
+
+To create a digital product:
+
+1. Create the product as described above and fill in the **Name**, **Description**, **Media**, and **Pricing** sections.
+2. In the **Shipping** section, set **Shipping Category** to a digital category (for example, **Digital** or **Digital Delivery**). When a cart contains only items in a digital shipping category, checkout skips the shipping step.
+3. In the **Tax** section, assign a tax category appropriate for digital goods (for example, **Downloadable Goods**).
+4. Save the product, then open its variant (or the master variant if the product has no options) and upload the file(s) to attach to that variant. Each digital file is associated with a specific variant.
+
+<Note>
+ Shipping and tax categories are managed in **Settings → Shipping** and **Settings → Tax**. If a "Digital" or "Downloadable Goods" category isn't listed yet, create it there first.
+</Note>
+
+### Download access and limits
+
+Spree generates a unique digital link with a token for each purchased line item. You can restrict how customers use that link from your store's digital product settings:
+
+- **Maximum downloads** - cap how many times the file can be downloaded per order (for example, 5).
+- **Link expiry** - set how long the link remains valid after purchase (for example, 3 days).
+
+When a customer exceeds either limit, the storefront returns an error and the file is no longer accessible from that link. Admins can resend the download email or regenerate the link from the order if needed.
+
+### How customers receive the file
+
+After an order is placed, customers can access their files in three ways:
+
+- **Order confirmation page** - download links appear on the success page immediately after checkout.
+- **Order confirmation email** - links are included in the email sent after purchase.
+- **My Account dashboard** - logged-in customers can return to their account to re-download (subject to the limits above).
+
+Internally, each download is served via `GET /api/v3/store/digitals/{token}`. The token alone authorizes the download — no API key or login is required — which is why download limits and expiry exist.
+
+For more on the digital product model, see the [Digital Products](/use-case/digital-products/admin-capabilities) overview.
+
## Save Changes
Once you’ve filled out all the required and optional fields, scroll to the bottom and click Create to publish the product (or save it as a draft).