Carousel Usage Guide – Apply JSON-LD Code

STEP 1

Using the web interface

1
Choose a carousel type
Pick the type that fits your content: generic item, product, recipe, course or movie.
2
Enter a carousel name
Enter a name that represents the whole carousel. e.g. "Popular products", "Recommended recipes"
3
Add item
Click the "Add item" button to add the content to include in the carousel.
4
Enter information
Enter each item's title, description, URL, image and other details.
5
Generate code
Click the "Generate code" button to create the JSON-LD and embed code.

STEP 2

How to apply the generated code

Method 1: Insert JSON-LD directly

Paste the generated JSON-LD code inside the <head> tag of your web page.

HTML head tag example

<head> <!-- existing head content --> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ItemList", "name": "Popular products", "itemListElement": [ { "@type": "Product", "name": "Product name", "url": "https://example.com/product1", "position": 1, "image": "https://example.com/image1.jpg", "description": "Product description" } ] } </script> </head>

Recommended

This is the most reliable method and the most effective for SEO.

Method 2: Use the embed JavaScript

Paste the generated embed code at the end of the <body> tag.

Embed script example

<body> <!-- page content --> <!-- Naver carousel embed code --> <script> (function() { var carouselData = { "@context": "https://schema.org", "@type": "ItemList", "name": "Recommended products", "itemListElement": [/* generated data */] }; // Auto-generate JSON-LD var script = document.createElement('script'); script.type = 'application/ld+json'; script.textContent = JSON.stringify(carouselData); document.head.appendChild(script); })(); </script> </body>

STEP 3

Using the external script

Basic usage

Basic embed

<script src="https://yourdomain.com/naver-carousel-embed.js" data-carousel-type="ItemList" data-carousel-name="Popular products" data-items='[{"name":"Product 1","url":"https://example.com/1","description":"Description 1"}]'> </script>

Generate the HTML structure too

Generate with HTML

<script src="https://yourdomain.com/naver-carousel-embed.js" data-carousel-type="Product" data-carousel-name="Recommended products" data-items='[{"name":"Product 1","url":"https://example.com/1"}]' data-create-html="true"> </script>

Programmatic usage

JavaScript API

// Create a carousel dynamically in JavaScript NaverCarousel.create({ type: 'Product', name: 'Best sellers', items: [ { name: 'Product 1', url: 'https://example.com/product1', description: 'The best product', image: 'https://example.com/image1.jpg', price: '₩29,900' } ] });

STEP 4

Fields by carousel type

Generic item (ItemList)

Required fields:

Title
URL

Optional fields:

Description
Image URL

Product

Required fields:

Title
URL

Optional fields:

Description
Image URL
Price
Brand

Recipe

Required fields:

Title
URL

Optional fields:

Description
Image URL
Cooking time
Main ingredients

Course

Required fields:

Title
URL

Optional fields:

Description
Image URL
Course duration
Instructor name

Movie

Required fields:

Title
URL

Optional fields:

Description
Image URL
Director
Release date

STEP 5

Optimization tips

Improve main page visibility

Adding the HTML structure along with JSON-LD can improve visibility on your main page.

Image optimization

Use images of an appropriate size (at least 696x392px) and format for your carousel.

Write descriptions

Keep each item's description concise and clear so it catches users' interest.

URL structure

Use clean, meaningful URLs.

Notes

No guaranteed display: Naver does not guarantee it will show a carousel. Structured data only helps search engines understand your content.
Accurate information: Provide accurate and up-to-date information.
No spam: Avoid spammy content and misleading information.

STEP 6

Troubleshooting

If your carousel doesn't appear

1
Validate structured data: Check that your JSON-LD is valid with Google's structured data testing tool
2
Check site registration: Confirm your site is registered in Naver Search Advisor
3
Content quality: Check your content's quality and relevance to search queries
4
Wait a few days: Wait a few days after applying structured data

If the data isn't parsed correctly

1
Check JSON syntax: Validate that there are no JSON syntax errors
2
Check required fields: Confirm all required fields for each type are included
3
Handle special characters: Check that special characters and Korean text are escaped correctly
4
URL validity: Check that all URLs are valid and accessible

How to use the Naver carousel generator

Using the web interface

Choose a carousel type

Enter a carousel name

Add item

Enter information

Generate code

How to apply the generated code

Method 1: Insert JSON-LD directly

Method 2: Use the embed JavaScript

Using the external script

Basic usage

Generate the HTML structure too

Programmatic usage

Fields by carousel type

Generic item (ItemList)

Product

Recipe

Course

Movie

Optimization tips

Improve main page visibility

Image optimization

Write descriptions

URL structure

Notes

Troubleshooting

If your carousel doesn't appear

If the data isn't parsed correctly

Create a carousel now!