Documentation & User Guide

Quick Start

Use this checklist when you already have a Gumroad product and your images are ready. Publisher can start a new page or reopen a compatible page you exported earlier.

1. Open publisher.html.
2. Create a new page or click Open Existing Page.
3. Choose a Theme Preset.
4. Customize the page content, sections, colors, images, video, and related products.
5. Click Save periodically to protect browser work. Save stores your working project in Publisher. Export Final HTML creates the finished page you upload to Gumroad.
6. Click Export Final HTML.
7. Upload the exported page to Gumroad using Gumroad's current CLI workflow.
8. Reopen the exported page later using Open Existing Page whenever updates are needed.

What Publisher Does

• Creates a polished, mobile-responsive final HTML page for a Gumroad product.
• Reopens compatible pages previously created with GetSkipa Publisher, so it can be used for ongoing page maintenance.
• Includes three built-in layouts: Centered Focus, Editorial Split, and Direct Visual.
• Includes Light and Dark modes, coordinated Theme Presets, custom colors, background styles, visual depth, and hero treatments.
• Runs locally by opening publisher.html. There is no Publisher account, server, login, tracking, or cloud sync.

What Publisher Does Not Do

• It does not create or manage your Gumroad account.
• It does not upload your product files or media to Gumroad.
• It does not connect directly to Gumroad or any other service.
• It does not replace Gumroad checkout, product delivery, refunds, customer accounts, or support settings.
• It does not build a storefront, SaaS site, backend application, or general-purpose website.

Step 1: Prepare Your Gumroad Product

Step 2: One-Time Gumroad CLI Setup

Gumroad currently uses a command-line tool for custom page publishing and for retrieving certain product details. You do not need coding experience. You only need to copy and paste the commands shown below.

brew install antiwork/tap/gumroad

gumroad login

Step 3: Collect Public Asset URLs

Images

1. Open the public Gumroad product page in your browser.
2. Open or right-click the image you want to use.
3. Copy the image address.
4. Open the copied address in a new browser tab to confirm it displays publicly.
5. Paste that public URL into the matching Publisher image field.

Video

Upload the video directly to the Gumroad product first and wait for processing to finish. Gumroad does not provide the same direct copy workflow for every video, so use the CLI to view the public video information.

Replace YOUR_PRODUCT_ID with the product ID shown by Gumroad:

gumroad products view YOUR_PRODUCT_ID --json --no-input \
| jq '.product.covers[] | select(.type=="video")'

Review the returned video object and copy the Gumroad-hosted public video URL, typically a field such as original_url or the public URL returned by the current CLI response. Paste that URL into Publisher's video field.

Step 4: Build Your Page

1. Open publisher.html.
2. Start from a blank project or click Open Existing Page to edit a compatible Publisher export.
3. Select a layout, Light or Dark mode, and a Theme Preset.
4. Customize the page colors, background style, visual depth, and hero treatment as needed.
5. Turn page sections on or off.
6. Replace the sample text with your own product copy.
7. Paste your Gumroad-hosted image and video URLs into the appropriate fields.
8. Review the live preview while you work.
9. Click Save after major changes.

Step 5: Export and Publish

1. Review every visible section and remove any remaining placeholder content.
2. Click Save to preserve the current project in this browser.
3. Click Export Final HTML.
4. Publisher uses the browser's normal download process. In many browsers the exported page is saved in Downloads, although the exact location depends on your browser and operating system settings.
5. Open the exported file locally and inspect the finished page.
6. Confirm that images, video, buttons, links, pricing, and responsive layout behave correctly.
7. Open Terminal and use Gumroad's current product update command for your product ID.
8. Add the local path to the exported HTML file. On a Mac, the simplest method is often to type the command, add a space, and drag the file into the Terminal window so its full path is inserted automatically.
9. Press Return and follow Gumroad's current prompts.
10. Open the public product page and test it as a buyer would.

Layouts

Colors and Themes

Publisher's own interface uses fixed GetSkipa styling. Your design settings affect only the live landing-page preview and the exported final HTML page.

• Page background changes the full generated page background.
• Section background changes cards, callouts, showcase panels, FAQs, creator panels, and purchase surfaces.
• Button & accent color changes purchase buttons, carousel controls, badges, and highlighted icons.
• Text color controls headings, navigation text, body copy, cards, FAQs, creator text, and purchase text.

Publisher automatically creates softer supporting text from the selected Text color for descriptions, captions, reassurance, and other secondary copy. Choose a Text color with strong contrast against both the Page background and Section background.

Light and Dark modes reset the editable colors to sensible starting values. Theme Presets apply a coordinated mode, color palette, background style, visual depth, and hero treatment in one click. You can customize every setting afterward; Publisher then identifies the result as a custom theme.

Background styles include Flat, Spotlight, Aurora, and Soft Glow variations. Visual Depth options range from restrained to more elevated card and media presentation. Hero Highlight places additional emphasis on the headline and product media.

Images and Video

• Product thumbnails: use a square image, at least 600 × 600, under 5 MB, in JPG, PNG, or GIF format.
• Product covers: 1280 × 720 and 16:9 is a strong default for Gumroad cover media.
• Video: upload it directly to Gumroad, wait for processing, retrieve its public Gumroad URL, then paste that URL into Publisher.

YouTube and Vimeo may work in Gumroad's standard product layouts, but they are not reliable inside Publisher-generated custom HTML pages. Gumroad-hosted video files provide the safest compatibility.

Publisher uses Fill Frame behavior, allowing images to fill the 16:9 media area without stretching. Some cropping may occur when an image does not match the frame's aspect ratio.

Hero and Product Showcase each support up to ten images. Zero images hides the media area, one image displays as a static image, and two to ten images automatically create a carousel.

Sections and Related Products

Section headings and supporting text can be customized. Blank supporting text is hidden in the exported page.

Related Products quantity can be set from 0–3. Each related product uses a thumbnail, product name, and public Gumroad product link. The raw URL controls the link but is not shown as page text.

Related products open in a new browser tab. Publish each related product before copying its link. Public links generally follow a pattern similar to https://yourname.gumroad.com/l/product.

Editing Publisher

On desktop, Design Controls, Preview, and Page Content scroll independently. This allows one panel to remain in place while you work in another. Editable text fields use a light highlighted background to make them easier to locate.

Product Name and Product Thumbnail are managed together under Product Identity. Hero badge text is edited in the Hero section.

Save

• Save stores the current project in the browser.
• Saved work can continue later on the same computer and browser.
• Save does not create a distributable HTML page.

Export Final HTML

• Export Final HTML creates the finished landing page.
• The exported page is the file you upload to Gumroad.
• The exported page can later be reopened with Open Existing Page.
• The exported page is independent of browser storage.

Return to Default State is located at the bottom of Design Controls. It asks for confirmation, clears Publisher work saved in the browser, and restores the original shipped defaults. Previously exported HTML files are not changed.

Opening Existing Pages

Open Existing Page allows you to reopen pages previously exported by GetSkipa Publisher.

1. Create page.
2. Export Final HTML.
3. Whenever you need to make changes, open publisher.html.
4. Click Open Existing Page.
5. Edit the page.
6. Click Export Final HTML again.

Open Existing Page makes Publisher practical for maintaining an entire family of products. Instead of rebuilding each page from scratch, open an existing product page, replace the product-specific content, then export a new finished page while keeping your branding, layout, colors, and overall presentation consistent.

• Current Publisher exports restore all supported Publisher project settings.
• Older Publisher exports are supported. Most visible content and design settings can be restored automatically, although older pages should always be reviewed before exporting again.

Writing Guidance

• Use the hero headline to describe the result the buyer wants.
• Use the subheadline to explain what the product is and how it helps.
• Keep paragraphs short and easy to scan.
• Use Benefits & Callouts for outcomes, features, learning points, before-and-after explanations, or creative product details.
• Use FAQs to answer real questions that could prevent a purchase.
• Use purchase reassurance to reduce uncertainty about checkout, delivery, support, or refunds.

Technical Tips for Using Publisher

• Save after completing major sections or making significant visual changes.
• Save protects browser work. Export Final HTML creates the distributable page.
• Export after major revisions so you have a current standalone page file.
• Keep versioned exports for important product updates.
• Use Open Existing Page to duplicate products that share branding, creator details, colors, and section structure.
• Start with a Theme Preset, then fine-tune individual settings.
• Replace every placeholder headline, paragraph, image, link, price, and FAQ before exporting.
• Disable sections you do not plan to complete.
• Use Gumroad-hosted media for the most dependable custom-page compatibility.
• Open every media URL in a separate browser tab before pasting it into Publisher.
• Open the exported final HTML page locally before publishing.
• Review the final page on both desktop and mobile.
• Remember that Publisher does not cloud-sync or back up the project saved in your browser.
• Use Return to Default State carefully because it removes the Publisher project saved in that browser.
• After every Gumroad update, review the public page and test every important link and purchase button.

Gumroad Responsibilities

You are responsible for creating and maintaining your Gumroad account and products, uploading product files, setting prices, uploading media, configuring native product settings, installing and using the Gumroad CLI, publishing the custom HTML page, and testing checkout.

Troubleshooting Basics

• Publisher does not open: double-click publisher.html directly from the extracted Publisher folder.
• Images do not appear: confirm the URL is public, opens in a browser, and is not a local file path.
• Video does not appear: confirm Gumroad finished processing it and that you copied the public Gumroad-hosted video URL.
• A section is missing: confirm the section is enabled before exporting the page.
• Where is my exported page? Publisher uses your browser's standard download behavior. Most browsers save exported pages in your default download location. If you cannot locate the file, check your browser's download history.
• Open Existing Page does not accept a file: Open Existing Page only supports pages previously created with GetSkipa Publisher. If a page has been heavily modified outside Publisher, some settings may not be recoverable. It cannot open arbitrary HTML pages.
• Saved work disappeared: confirm you are using the same browser and have not cleared its local storage.
• Gumroad rejects the command or page: review Gumroad's current CLI and custom-page documentation because its requirements may have changed.

License Summary

GetSkipa Publisher is licensed to the original purchaser for authorized use only. Do not redistribute, resell, sublicense, publish, or distribute Publisher itself or modified copies of Publisher without written permission from GetSkipa LLC.

You may use Publisher to create your own authorized Gumroad product pages for products you are allowed to sell.