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


The Cosmic team was honored to to speak at Toyota Connected for the Ember.js Dallas Meetup this week. Cosmic co-founder Tony Spiro presented "Building Modern Apps with API Services" to illustrate the growing trend of offloading core dev tasks onto best-in-class API services.
Here I am going to explain the complete process to implement an Angular 6 blog, which uses Cosmic as back-end.
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.
In this tutorial I’ll demonstrate how to build an Authentication app using Angular 6 and Cosmic. Starting from scratch, learn how to build, configure and deploy this Angular6 Auth app to the Cosmic App Server for testing purposes.
Thanks to all who attended our first webinar / AMA last week. There was some great engagement and questions that helped steer the screen-share webinar for users in the Cosmic Community as well as first-time visitors to the system. If you missed it, check out the video and attend our next one.
This article walks through an approach to build a web application using Angular and Cosmic to help generate marketing leads for your team.

Get Started with Cosmic

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