is_bundle: Definition

Use the is_bundle attribute to indicate that you’ve created a bundle: a main product that you’ve grouped with other, different products, sold together as one package for a single price. 

This attribute lets us show your ad in the right situations by distinguishing your item from manufacturer-created bundles, multipacks, and other products without accessories.

An illustration of a bundle that includes a camera body, lens, and bag

When to use

Required if you’ve created a bundle containing a main product and you’re targeting any of the following countries:

  • Australia
  • Brazil
  • Czechia
  • France
  • Germany
  • Italy
  • Japan
  • Netherlands
  • Spain
  • Switzerland
  • United Kingdom
  • United States

The main item of a bundle is the featured product of those items included in the bundle. The additional items should be accessories or add-ons that complement the main item. Examples:

  • For a doll sold with a set of clothes that aren’t packed with the doll, the doll is the main item and the clothes complement it.
  • For a video game console sold with three video games, the video game console is the main item.

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type Boolean
Supported values
(Text and XML feeds)

yes, true, no, false

Supported values
(Content API feeds)
true, false
Repeated field No
 
File format Example entry
Text feeds

yes

XML feeds <g:is_bundle>yes</g:is_bundle>
Content API v2 (JSON) "isBundle": "true"
Content API v2 (XML) <is_bundle>true</is_bundle>

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • Submit yes if your product is a custom bundle consisting of different products that you created, and the bundle includes a main product. For example, a camera combined with a lens and bag. If you don't submit the attribute, the default is no.
  • Don’t submit is_bundle for a manufacturer-defined bundle.

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Describe the entire bundle. For example, submit content for image_link, title, and description that take into account the entire bundle.
  • Submit the correct condition. For example, if any item in the bundle is used, then submit the condition as used.

Customized products

Use the is_bundle attribute to let us know that the product includes customization like engraving or other personalization.

Examples

Merchant-defined bundle

Product Chromebook bundled with laptop case and extra battery
title 11.6″ Chromebook - 16 GB SSD + Laptop Case and 3990mAh Battery
is_bundle yes

 

Product Google 25.3 MP Digital SLR Camera and accessories
title Google 25.3 MP Digital SLR Camera Body + Accessory Bundle
price 432.50 USD
brand google
is_bundle yes

 

Product Hat and scarf set
title Google Logo Hat and Scarf Set
is_bundle no (or don’t submit this attribute at all)

Toys

You might also group toys with accessories such as a doll with clothes.

Product Android doll with sequin outfits
title 18” Android Doll + Matching Sequin Shirt and Pants
is_bundle yes
 
 
Was this article helpful?
How can we improve it?