Download the Spanish version of this article here.
Descarga la versión en español de este artículo aquí.
To enable the Product Feed integration you can import all product details into your account's editor using an XML or TSV product data feed. Before submitting a feed, we highly recommend running through the specifications below to ensure your feed is properly formatted.
In this article:
- Supported hosting formats
- UTF-8 Encoding
- Using an XML feed
- Using a TSV feed
- Using HTML to apply styling to descriptions
- Troubleshooting your product feed
Supported hosting formats
Publitas imports the product data directly from the external address the feed is hosted on.
The following feed URL types are supported for linking your feed to Publitas:
- HTTP, for example: http://hosting.domain.com/feed.tsv
- HTTPS, for example: https://hosting.domain.com/feed.tsv
- FTP, for example: ftp://hosting.domain.com/folder/publitas_product_feed.tsv
- SFTP, for example: sftp://user:email@example.com/folder/publitas_product_feed.tsv
Besides the supported protocols, please also consider the following aspect in order to import your feed successfully:
- No user-agent restrictions should be set.
- Traffic from the EU should not be blocked.
- The feed URL does not redirect traffic in any way.
- When using SFTP, make sure the password only contains URL safe characters (so no reserved characters, like & or *). If required, we can set up an SFTP location for you. For more information, contact firstname.lastname@example.org.
- Push the latest feed to the same location, under the same file name to avoid the feed URL changing after each update.
The content of the feed needs to be UTF-8 encoded. This also means that special characters will have to be converted to their UTF-8 counterpart. For example. the ampersand & needs to be converted to &
Using an XML feed
Find the full overview and details of the supported XML attributes in Supported Feed Attributes
- Apply the RSS 2.0 formatting and UTF-8 encoding
You can also enclose content in CDATA in which case, special characters do not have to be encoded. For example:
Without CDATA: <g:title>Bed & Breakfast</g:title>
Enclosed in CDATA: <g:title><![CDATA[Bed & Breakfast]]></g:title>
- Here is a link to a working XML Product Feed
|Example of the RSS 2.0 formatting in an XML feed:
<?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"> <channel> <item> <g:id><![CDATA[A12345]]></g:id>
Using a TSV feed
Find the full overview and details of the supported TSV attributes in Supported Feed Attributes
- This format requires a tab-delimited text file (.tsv or .txt) hosted on an external service according to the following specification.
- The first line (or first row) contains the attributes names using lower case letters only.
- All other lines contain the specific values for the separate products.
- The attributes and the product details are separated by a tab (avoid using tabs for reasons other than separating the individual values).
- Combine up to 5 additional images under the additional image link attribute, by separating the different URLs with a comma (no space).
- If automatic updates is not a requirement (yet), you can use Google Sheets to create and host a TSV feed. This process works with tab separated values (TSV), comma separated values (CSV), Excel files or by pasting all product data in Google Sheets directly.
- Here is a link to a working TSV Product Feed
Using HTML to apply styling to descriptions
Using HTML the content of the description attribute can be styled. For this, the following HTML methods are supported:
- <h1> = Heading 1
- <h2> = Heading 2
- <h3> = Heading 3
- <p> = Paragraph
- <small> = Smaller text
- <a> = Hyperlink
- <ul> = Unordered list (bullets)
- <li> = List (numerals)
- <b> = Bold text
- <em> = Emphasised text (italics)
- <strong> = Important text (more distinct than bold & italics)
- <sup> = Superscripted text
- <sub> = Subscripted text
- <u> = Some text that is unarticulated % styled differently from normal text (eg. underline, but distinct from a hyperlink)
- <br> = Single line break (doesn't need styling)
- image = Add an image: <div><img src="IMAGE_URL" alt="ALT_TITLE" width="###" height="###" /></div>
All other HTML is sanitized to avoid conflicts with embed page css or risk breaking the modal window.
NOTE: HTML cannot be used to style product titles. If HTML is present it will be converted to plaintext:
Troubleshooting your product feed