In Tweakwise, everything starts with products but that’s not where it ends. The platform is designed to be flexible, so you’re not limited to just product data. You can also manage and optimize other types of content. We call these items.

What are items

Items are the building blocks of your data feed. A product is one type of item, but items can be anything: blog articles, lookbooks, recipes: you name it! As long as the data can be structured similarly to a product (like a name, image, url), you can treat it as an item in Tweakwise.

The big advantage is flexibility. By treating other types of content as items, you can enrich your lister pages with inspirational content or combine products and content in a single view

This means you get a more complete experience for your users, but without a huge investment on your platform.

Item types

To keep everything organized, you’ll want to tell Tweakwise what kind of item it’s dealing with. This is done using an attribute. Usually something like type, itemType, or contentType Common values might be:

• product
• blog
• inspiration
• visual

You decide what the attribute is called and which values to use.

By default, we treat all items as products. In the Tweakwise app, you can configure the attribute as item-type characteristic. This will allow us to distinguish the different item types and unlocks new functionalitity.

Working with item types

When configured, the item-type characteristic will be exposed through our API. You'll notice there is a type field for every item returned by the Delivery API.

<item>
  <type>product</type>
  <itemno>10001-101</itemno>
  <title>Tweakwise Hoodie Blue</title>
  ...
</item>

{
    "type": "product",
    "itemno": "10001-101",
    "title": "Tweakwise Hoodie Blue",
    // ...
}

In your platform you can use this type property to render products, visual or any other item type you set.

Predefined types

To avoid potential conflicts with future predefined types, it's recommended to prefix your custom types accordingly.

Example

Read how you can use this to integrate a visual in lister pages 👉