The new Cosmic dashboard is here!
Test drive it now →

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


Cosmic allows you to easily create nested structures and upload media files. We learn how nested structures are built and how you can fetch such data from Cosmic API to use in a simple music site app.
This article shows you how to create a blazing fast Gatsby JS blog using Cosmic source plugin. Let’s get started.
This article demonstrates how to create a company website using Cosmic and Angular in a few steps.
See how easy it is to create a browser based video game when using Cosmic to manage all of your data.
In this article I’m going demonstrate how to publish new Objects containing survey responses in Cosmic as they are completed in Typeform. Click here to connect Typeform to Cosmic using Zapier.

Get Started with Cosmic

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