Troubleshooting PDF Delivery Settings

Solutions for common issues with PDF delivery settings, image uploads, previews, and per-listing overrides.

Upload issues

Logo or banner upload fails

Symptoms: The upload spinner appears but the image never saves, or you see an error toast.

Solutions:

• Verify the file is a supported format: JPEG, PNG, WebP, or GIF.

• Check the file size. Very large images (over 10 MB) may time out. Resize or compress and try again.

• Make sure you have an active internet connection.

• Try a different browser or clear your browser cache.

"Uploading..." spinner never finishes

Solutions:

• Wait at least 15 seconds — large files take longer to process.

• If the spinner persists, refresh the page and try the upload again.

• Check your browser's developer console (F12 → Console) for network errors. A 413 error indicates the file is too large.

Shop logo not appearing

Solutions:

• Verify you have a connected Etsy shop in your account settings.

• If your Etsy shop doesn't have an icon set, upload a custom logo instead.

• If you recently changed your Etsy shop icon, try refreshing the page.

Preview issues

Preview won't load or shows a blank frame

Solutions:

• Make sure your settings have saved. Look for the "Saved" indicator.

• Refresh the page and try generating the preview again.

• Check if your browser blocks embedded content (iframes). Some privacy extensions can block the preview viewer.

• Try a different browser.

Preview doesn't reflect my latest changes

Solutions:

• Auto-save runs on an 800ms delay. Wait for the "Saved" indicator before previewing.

• For image uploads, refresh the preview after uploading a new image.

• If previewing a specific listing, confirm you are looking at the right listing's overrides.

Preview looks different from expected

Solutions:

• Double-check your color values in the picker.

• If using a per-listing preview, the listing may have overrides that differ from global settings.

• Some fonts render differently in PDF than on screen.

• Banner images use cover cropping, so the PDF may show a different crop.

Override issues

Per-listing override not taking effect

Solutions:

• Verify the override was saved (look for "Saved" indicator).

• Empty override fields inherit from global settings. Make sure the field contains text.

• Refresh the Listing Optimizer and re-open the listing.

Override field label is not highlighted

Solutions:

• The highlight appears only when the override value differs from the global value.

• After saving, the highlight updates automatically. If it doesn't appear, refresh the page.

Resetting an override doesn't restore the global value

Solutions:

• Clear the field completely and wait for auto-save to complete.

• If the issue persists, refresh the page.

Formatting issues

Text looks cut off or overflows

Solutions:

• Keep text concise. The PDF has a fixed width, so long lines wrap.

• For the coupon code, aim for under 20 characters.

Coupon block doesn't appear

Solutions:

• The Coupon Block toggle must be enabled in global settings.

• The enable/disable toggle is global only. Per-listing overrides can change coupon text but not toggle visibility.

Social links section is empty

Solutions:

• Add at least one social link with a platform and URL. The toggle alone doesn't create content.

Download buttons not showing

Solutions:

• At least one of Download All or Individual Download Buttons must be toggled on.

• Check per-listing overrides — an override can disable buttons independently.

Footer or branding not visible

Solutions:

• Footer text only appears if the field contains content.

• The ListingView branding toggle must be on (required on free plans).

Still need help?

1. Take a screenshot of the settings page and the preview showing the problem.

2. Note which listing(s) are affected and whether the issue is with global settings or per-listing overrides.

3. Contact support with these details for faster resolution.

Related features

• PDF Delivery Settings Overview — Full guide to all configuration options

• Per-Listing Overrides — How per-listing overrides work and how to reset them

• Preview & Formatting — How to generate and review PDF previews

• Uploading & Replacing Images — Image upload details and best practices