How to Add HTML to an eBay Listing Description: Step-by-Step Guide
How to Add HTML to an eBay Listing Description: Step-by-Step Guide
You have found an eBay HTML description template you like, or you have built one yourself, and now you need to get it into your listing. You paste it into the description box, and instead of a neat, professional layout, you see a wall of code on the page. It is one of the most common frustrations for eBay sellers, and the fix is simple once you know where to look.
In this guide, we explain how to add HTML to an eBay listing description step by step, what eBay does and does not allow, and how to make sure your description looks just as good on a phone as it does on a computer.
Why use HTML in your eBay description?
HTML is the code that controls how your description is laid out and styled. Using it lets you add proper headings, clear sections, brand colours and a consistent layout across every listing. Done well, it makes your listings look more professional, helps buyers find the information they need faster, and saves you time because you are no longer formatting each description from scratch.
What eBay allows in HTML descriptions
eBay allows standard HTML and CSS in item descriptions, but it does not allow active content. According to eBay's JavaScript policy, examples of active content include scrolling item pickers, embedded Feedback, social sharing icons and currency conversion widgets. If you include it when creating a listing, you will see a "Disallowed JavaScript/HTML Syntax" error and will not be able to list the item until it is removed.
Links are also restricted. Any links in your description must follow eBay's links policy, so you should not link to your own website or encourage buyers to purchase outside eBay. In short, keep your code to clean HTML and styling, and leave out scripts, forms, embedded videos, iframes and third-party widgets.
How to add HTML to an eBay listing, step by step
1: Get your HTML ready
Start with the complete HTML for your description, whether that is a template you have bought, one you have created in a builder, or code you have written yourself. Open it in a plain text editor and fill in your item details first, so you are pasting in a finished description rather than editing code inside eBay's form. If you do not have any HTML yet, an eBay HTML description template generator such as Listing Buildr will create it for you from a visual design.
2: Open the description section of your listing
Create a new listing, or revise an existing one, and scroll down to the item description section. By default, eBay shows a standard text editor with basic formatting buttons. This is the reason HTML pasted straight into the box appears as code, because the editor treats it as ordinary text.
3: Switch to the HTML view
Look for the option in the description editor to switch to HTML or source code view. eBay updates its listing form from time to time, so the exact label and position can change, but it is usually shown in the description toolbar. Once you switch, the box will show the raw code behind your description instead of the formatted text.
4: Paste your HTML
Delete anything already in the HTML box, then paste in your complete code. Make sure you have copied everything from the first line to the last, because a missing closing tag can break the layout of the whole description.
5: Switch back and check the result
Switch back to the standard view, or use the preview option, and check that your description displays correctly. Look for missing images, broken sections or text that runs off the edge. If something looks wrong, go back to the HTML view and check that the code was pasted in full.
6: Preview on mobile before you publish
This is the step most sellers skip, and it matters more than any other. Open the listing preview on your phone, or use your browser's mobile view, and check that the text is readable, images fit the screen and nothing forces the buyer to scroll sideways. If the description does not work on a phone, a large share of your buyers will never read it properly.
Adding images to an HTML description
Images in an HTML description are not uploaded in the same way as your main listing photos. Instead, the code links to an image that is hosted online. Make sure each image uses a secure web address beginning with https, and set images to scale to the width of the screen rather than using a fixed size, so they do not overflow on mobile. Keep in mind that eBay's main listing photos are still the most important images, so use description images to support them rather than replace them.
Adding HTML to lots of listings at once
If you have hundreds of listings, pasting HTML into each one by hand is not practical. Most bulk listing tools and eBay's own bulk upload templates let you include HTML in the description field, so you can apply the same template across many items in one go. Whichever method you use, test one listing fully before rolling the template out across your whole shop.
Common mistakes to avoid
The most common mistake is pasting HTML into the normal text view, which shows the code on the page instead of the design. The second is copying old templates from the internet that still contain scripts or widgets, which trigger eBay's active content error. The third is using fixed widths, which force buyers on mobile to scroll sideways. And the fourth is editing complicated code directly inside eBay's form, where it is easy to delete a tag by accident and break the layout.
The easier way: generate your HTML without coding
If editing code is not something you enjoy, you do not have to. With ListingBuildr, you design your eBay description visually, preview it on desktop and mobile, and copy the finished HTML straight into the HTML view of your listing. It removes most of the mistakes above, because the code is generated for you. You can design your HTML visually instead of writing code and try it on your own listings.
If you would prefer a finished design, Sellertivity's eBay listing description templates come ready to use, with sections for features, condition and postage already laid out. You add your details and paste the code into eBay.
Final thoughts
Adding HTML to an eBay listing is simple once you know to switch to the HTML view before pasting. Keep your code clean and free of active content, check every description on a phone before you publish, and use a template so you are not rebuilding the layout each time. Get those basics right, and every listing you publish will look more professional and be easier for buyers to trust.
For more practical eBay and marketplace advice every week, join our free 3 Minute Marketplace newsletter.