Content Block Types

When using the Designs from Content API, you can specify various types of content blocks within the content object. This document provides details about all supported content block types and how to use them effectively.

Text-Based Content Blocks

These content blocks are used for various types of textual content in your designs:

Block Type	Description	Example
title	Main headline or title for your design	"title": "Discover the Freedom"
supertext	Text that appears above the title (often smaller)	"supertext": "New Year"
subtext	Supporting text that appears below the title	"subtext": "Explore our latest collection of cars and bikes."
text	General body text content	"text": "Leading auto portal for content and commerce hitting 30 Mn+ unique visitors month."
caption	Small explanatory text, often used with images	"caption": "Terms and conditions apply."

Call-to-Action Blocks

These blocks help engage users to take specific actions:

Block Type	Description	Example
button	Text for buttons or call-to-action elements	"button": "Shop Now"
coupon	Coupon or promo codes	"coupon": "BONUS20"
offer	Special offer or promotion text	"offer": "Limited Time: Up to 20% Off"

List Content Blocks

For presenting information in list format:

Block Type	Description	Example
bulletlist	Array of items to display as a bulleted list	"bulletlist": ["Wide range of models", "Best price"]
numberedlist	Array of items to display as a numbered list	"numberedlist": ["Free Service", "Offer price"]

Date and Time Blocks

For time-sensitive content:

Block Type	Description	Example
date_time	Date and/or time information	"date_time": "12th July 2024"

Contact Information Blocks

For including contact details in your designs:

Block Type	Description	Example
phone	Phone number	"phone": "+1 (800) 3543 323"
email	Email address	"email": "joe@example.com"
website	Website URL	"website": "www.example.com"
address	Physical address	"address": "40, M. Ave, Richmond road, US"

Social Media Blocks

For incorporating social media handles:

Block Type	Description	Example
whatsapp	WhatsApp contact number	"whatsapp": "+1 6351621222"
instagram	Instagram handle	"instagram": "@example"
facebook	Facebook username	"facebook": "example"
linkedin	LinkedIn username	"linkedin": "joe_example"
twitter	Twitter/X handle	"twitter": "@example"
behance	Behance username	"behance": "example"
dribbble	Dribbble username	"dribbble": "example"
pinterest	Pinterest username	"pinterest": "example"
slack	Slack workspace name	"slack": "example"

Best Practices

1. Include necessary content blocks: Different design types may require specific content blocks. For example, an advertisement design typically needs a title, offer, and button.

2. Keep content concise: For optimal design generation, keep your content brief and to the point.

3. Combine with assets: Pairing appropriate content blocks with relevant images and logos (via the assets object) yields the best design results.

4. Plan hierarchically: Consider how content will be organized - titles should be brief and attention-grabbing, while supportive text can provide details.

Example Usage

Here's a comprehensive example showing how various content blocks can be combined:

{
  "content": {
    "title": "Summer Collection 2025",
    "supertext": "New Arrival",
    "subtext": "Premium quality at affordable prices",
    "offer": "Limited Time: Up to 30% Off",
    "bulletlist": [
      "Ethically sourced materials",
      "Free shipping on orders over $50",
      "30-day money-back guarantee"
    ],
    "button": "Shop Now",
    "date_time": "August 31, 2025",
    "website": "www.example-store.com",
    "instagram": "@example_fashion"
  }
}