How to Add Localization to Bucket Object Types

Community Articles
Community Articles How to Add Localization to Bucket Object Types

Below is a step-by-step tour of how to add the power of Localization to your Cosmic Object Types.


1. Localization happens on the Object Types.  To set up localization in your Bucket go to Your Bucket Dashboard > Object Type > Settings (Cog icon)



2. Then turn localization for this Object Type “On”


3. Select your locales



4. Select your priority local (this will be the display title in the Objects Table)



5. Then on your Object Pages, you will see the Locale option



6. When you want to add the same Object (but in a different language / locale) simply create a new Object, *make sure the slug is the same* and add the different locale


7. Save this Object, then you will see that the Object now appears in the Table with 2 different locales linked


8. Now that you have the 2 versions, you can get the different versions from the API endpoint using the `locale` query param

EN Version:
https://api.cosmicjs.com/v1/install/object/aquamarine?pretty=true&hide_metafields=true&locale=en-US

ES Version:
https://api.cosmicjs.com/v1/install/object/aquamarine?pretty=true&hide_metafields=true&locale=es

This `locale` parameter is available on all endpoints, so if you need to get all Objects with `locale=es`:
https://api.cosmicjs.com/v1/install/object-type/products?pretty=true&hide_metafields=true&locale=es

Or EN:
https://api.cosmicjs.com/v1/install/object-type/products?pretty=true&hide_metafields=true&locale=en-US


I hope you found this article helpful.  Let me know if you have any further questions.  Reach out to me on Slack, and follow Cosmic on Twitter.

You may also like


Build a static web page for your company or personal portfolio using the Gatsby static site generator and the Cosmic Content Management Platform.
Exporting Cosmic-powered data to CSV is easy with this new extension 🚀
A website boilerplate satisfies some common website requirements including dynamic pages, blog articles, author management, SEO ability, contact form and website search.
To demonstrate how easy it is to get started with Cosmic, we'll utilize the Cosmic CLI to quickstart a React Auth App. This app shows implementation of Authentication in ReactJS, NextJS and NodeJS using the Cosmic API. This app has all the basic modules like signin, signup, view/edit profi
Next.js is a React framework for building hybrid applications. It's flexible, extensible, and works great with any data provider. In this tutorial, we'll show how to get started with Cosmic CMS and Next.js.
For simple shopping websites, going with full-fledged solutions like Shopify or Woocommerce can be a total overkill. In this tutorial, we're going to build an e-commerce website using Nuxt and Cosmic.

Get Started with Cosmic

Build personal projects for free. Add your team at unbeatable prices.
Start Building Talk to Sales