Want to track your sales performance and profit? Access comprehensive sales data by navigating to the Selling Tools > Sales History > Manage, where you can download detailed reports.
- Detailed CSV Introduction
- Type Reference Chart
- Detailed CSV Examples Section
- Summary CSV Introduction
- Footnotes
- File Naming
You can download two types of CSV files:
- Detailed CSV: Line-by-line breakdown of every order item
-
Summary CSV: High-level overview of complete orders
Detailed CSV Introduction.
The Detailed CSV provides a lin-by-line breakdown of every individual item sold across all your orders. Each row represents a single item, coupon, or adjustment from an order, including sales, adjustments, coupons, and fees. For order-level information like shipping addresses and totals, refer to the Summary CSV.
Detailed CSV Column Definitions.
| Column Name | Definition |
| OrderID | Unique identifier for the order (same across all items in that order) |
| Date | Date when the order was placed |
| Quantity | Number of items ordered for this line item |
| Currency | Currency used for the order |
| Base Price | Cost per item before your markup |
| Price Charged | Your selling price per item (what the customer paid) |
| Profit | Your estimated profit for this line item (includes all quantities for this row) |
| Charges | Amount charged to your credit card for this item (if applicable) |
| Tax | Sales tax collected for this item (passed to you if you're registered for tax remittance) |
| Shipping Cost | Shipping charges for this item/order |
| Type | Category of line item (Sale, Coupon, Adjustment, etc. - see reference chart below) |
| Name | Description of the specific item or adjustment |
| Payment Status |
|
| Payment Date | Date when profit was paid to you or when charges were captured. Note: This may be several days before or after the actual deposit/payment due to processing times. |
| Payment Info |
|
| Payment Currency | The currency of the payment |
| Payment Exchange Rate | The exchange rate at the time of the payment |
| Link | Direct link to the image |
| Filename | Image filename |
| ImageID | Unique identifier to the image |
| AlbumID | Unique identifier to the album containing the image |
| Category Hierarchy | Full category path for the album (Category/Subcategory/etc.) |
| Gallery Title | Name of the album/gallery containing the image |
Type Reference Chart.
| Type | Meaning |
| Sale | This row represents a single item purchase by a customer. Each physical product (print, merchandise, etc.) appears as a separate sale row showing the item name, quantity, pricing, and profit information. |
| Various Coupons | When a customer applies a coupon code during checkout, it creates a separate row showing the coupon usage. The Name column displays the specific coupon code entered by the customer, and the row shows the coupon's title/description as it existed when the coupon was used. This helps you track which promotional codes are being redeemed. |
| Various Adjustments | Any modification to your profit from an order appears as a separate adjustment row. This includes coupon discounts applied to your profit, branding service charges, administrative corrections made by SmugMug, or other profit modifications. The Name column typically describes what caused the adjustment, making it easy to understand why your profit was changed. |
| Various Feature In Use Fees | Charges for premium features or services that result in fees to your account. The Name column shows what service generated the charge (often related to coupon usage or special services). The payment information columns show when these fees are billed to your credit card on file. |
Detailed CSV Examples Section.
Complex transactions may generate multiple rows to show different aspects of the same event. For example, when a customer uses a coupon, you'll see separate rows for the original sale, the coupon usage and the profit adjustment:
| OrderID | Date | Quantity | Base Price | Price | Profit | Charges | Sales Tax | |
| 13 | 10577839 | Sep 22, 2023 | 1 |
121.45 | 180 | 49.77 | ||
| 14 | 10577839 | Sep 22, 2023 | 1 |
347.35 | 450 | 87.25 | ||
| 15 | 10577839 | Sep 22, 2023 | 1 |
196/30 | 280 | 71.14 | ||
| 16 | 10577839 | Sep 22, 2023 | 1 |
2.70 | 50 | 39.29 | ||
| 17 | 10577839 | Sep 22, 2023 | 1 |
-292.20 | ||||
| 18 | 10577839 | Sep 22, 2023 | 1 |
-247.45 |
In this example, a customer purchased several prints and used an at-cost coupon. The data breaks down as follows:
- Rows 13-16: Each row represents the sale of a different print product, showing the base price, the price charged to the customer, and the profit earned from each item.
- Row 17: Displays the coupon usage. This reflects the value of the discount applied at checkout.
- Row 18: Shows how the coupon reduced your profit. The entire profit from the sale was offset by the coupon.
Because the total discount was equal to or less than the total profit, no additional charge row appears. This is key: when an at-cost coupon only eats into your profit, you're not charged out of pocket. However, if the discount exceeded your profit, you would see a separate charge row reflecting the remaining cost covered by you.
| Row | OrderID | Date | Quantity | Base Price | Price | Profit | Charges | Sales Tax |
| 58 | 2134 | April 27, 2025 | 3 |
148.35 | 289.53 | 120 | ||
| 59 | 2134 | April 27, 2025 | 1 |
-521.15 | ||||
| 60 | 2134 | April 27, 2025 | 1 |
-120 | ||||
| 61 | 2134 | April 27, 2025 | 1 |
-401.15 | ||||
| 62 | 2134 | April 27, 2025 | 1 |
-1.00 | ||||
| 63 | 2134 | April 27, 2025 | 1 |
23.89 |
This example shows a more complex scenario: Row 58: A customer ordered 3 large canvas prints at $289.53 each (marked -up price), which would normally generate $120 in total profit. However, they used a 60% off coupon, creating the following breakdown:
- Row 59: Coupon discount of $521.15 applied to the customer
- Row 60: Your profit of $120 was eliminated entirely by the discount
- Row 61: the remaining $401.15 of the discount (beyond your profit) was charged to you.
- Row 62: A $1 branding fee was charged for custom branding.
This demonstrates how large coupon discounts can result in charges to your account when the discount exceeds your profit margin.
Summary CSV Introduction.
The Summary CSV provides one row per order with complete order totals and customer information. This gives you the big picture view of each transaction, while the Detailed CSV breaks down individual items within each order.
Summary CSV Column Definitions.
| Column Name | Definition |
| OrderId | Unique identifier for the order |
| Date | Date and time when the order was placed |
| Customer E-mail | The customers name and email address. (See footnote 1) |
| Billed Name | Name of the person who paid for the order |
| Billed Street1 | Billing street address information 1 |
| Billed Street2 | Billing street address information 2 |
| Billed City | Billing city |
| Billed State | Billing state |
| Billed Zip | Billing zip code |
| Billed Country | Billing country |
| Billed Phone | Billing Phone |
| Shipped Name | Name of the shipping recipient (may be anonymized for non markup sales) |
| Shipped Street1 | Shipping street address information 1 |
| Shipped Street2 | Shipping street address information2 |
| Shipped City | Shipping state |
| Shipped Zip | Shipping zip code |
| Shipped Country | Shipped Country |
| Shipped Phone | Shipped Phone |
| Quantity | Total number of items in the order |
| Currency | Currency used for the order |
| Base Price | Total cost of all prints and merchandise before markup |
| Price Charged | Total amount charged to the customer |
| Est. Profit | Estimated total profit for the order (includes all adjustments) |
| Charges | Total charges to your credit card from this order |
| Photo Add-Ons (Base) | Base cost of photo add-ons |
| Photo Add-Ons (Charged) | Cost charged to the client |
| Tax Currency | Currency used for the tax |
| Total Tax | Any tax collected for your portion of the order (includes both your state tax and CA tax where applicable) |
| Shipping Method |
|
| Shipping cost | Shipping and handling charges allocated to your items (for orders with multiple photographers, this shows only your portion) |
| Profit Status | Payment status for the order (same as Detailed CSV, plus Mixed when partial payments or post-payment adjustments have occurred - check Detailed CSV for specifics) |
| Profit Date | Date when profit was paid to you (same as Detailed CSV) |
| Profit Info | Payment method identifier - date format indicates direct deposit batch, numbers, may include special notes (same as Detailed CSV) |
| Profit Currency | Currency used for profit payment |
| Profit Exchange Rate | Exchange rate applied when profit was paid (for Non-US accounts) |
| Order Link | Direct link to view this order in your Sales History |
Footnotes.
- Customer information is limited for non-markup sales to protect privacy. However, billing state is always shown when sales tax is collected so you can determine your tax reporting obligations.
- Shipping information is anonymized for non-markup sales to protect customer privacy.
- The Summary sheet shows sales tax for both your state (if enabled) and California. California tax is handled by SmugMug and not remitted to you.
File naming.
When you download these CSV files, the filenames are of the following pattern:
| Nickname | Static Filename | Filters (optional) | Details (optional) | Extension | |
| nickname | -SmugMug-sales |
-(paid status) (time period) |
-detailed | .csv | |
| 1 | cabbey | -SmugMug-sales | -Paid-LastYear | .csv | |
| 2 | schmootography | -SmugMug-sales | -detailed | .csv |
Example 1: User "cabbey" applies filters for "Paid" status and "Last Year" date range, then downloads the Summary CSV. The filename would be: cabbey-SmugMug-sales-Paid-LastYear.csv
Example 2: User "cabbey" applies the same filters ("Paid" and "Last Year"), but downloads the Detailed CSV instead. The filename would be: cabbey-SmugMug-sales-Paid-LastYear-detailed.csv