Using the Product Feed integration to import product details into your account's editor requires an XML or TSV product data feed which is hosted online.
Before submitting a feed, we highly recommend running through the specifications below to ensure your feed is properly formatted.
- Supported hosting formats
- UTF-8 Encoding
- XML feed specifications
- TSV feed specifications
- Using HTML to apply styling to descriptions
- Recommendations and things to consider
- 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 *).
- Push the latest feed to the same location, under the same file name to avoid the feed URL changing after each update.
If required, we can set up an SFTP location for you. For more information, contact firstname.lastname@example.org.
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 &
If you are unsure whether your attributes are fully compatible, it is best practice to enclose them as CDATA: <![CDATA[enter the value here]]>.
XML feed specifications
- Apply the RSS 2.0 formatting and UTF-8 encoding
- Publitas supports the following attributes:
- g:availability (more info)
- g:additional_image_link (Publitas imports up to 5 separate g:additional_image_links)
- Alternatively, the attributes <g:title>, <g:description> and <g:link> are also supported.
- Here is a link to a working XML Product Feed
Below is an example of the XML syntax, using only the item attributes that are imported by Publitas. You do not have to remove additional attributes from the feed, these will be ignored when imported into Publitas.
<?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>
TSV feed specifications
This format requires a tab-delimited text file (.tsv or .txt) hosted on an external service according to the following specification.
- Publitas supports the following attributes:
- sale price
- availability (more info)
- image link
- additional image link
- The first line contains these attributes (note: all the attributes in the first line must start and be written in lower case letters, and in English).
- All other lines represent 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).
- Use a comma (no space) to combine up to 5 additional images under the single attribute.
- 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.
Recommendations and things to consider
- The id and title attributes are required elements. If one of the required elements is not present, the product will not be imported. In the Product Feed menu, recent imports are logged. If a selection of products could not be imported the log will show this under Details:
- When creating a product hotspot, the product details are kept in sync with the product feed. This requires the product id for each product to be unique. If multiple products share the same product id, only one of them gets imported into Publitas. See Keeping your products synced with your product feed for more information.
- To improve the loading speed of the product details we recommend using an image resolution of 1000 x 1000 pixels for the product images, which will produce enough detail for the users to zoom in on.
- Publitas can import up to 300.000 products from a single feed.
- HTML cannot be used to style product titles. If HTML is present it will be converted to plaintext:
- If automatic updates is not a requirement (yet), also have a look at Using Google Sheets to host your TSV feed
- If you are using Lengow or Channable as your feed management tool, you can select Publitas as a channel.