How to lock device orientation for React Native apps (Android & iOS)— 2x02

Tasos Maroudas
Oct 9, 2018 · 3 min read

This story is part of a series where I am sharing my experiences on React Native, hoping it will prove useful to the React Native community and provide helpful insights.

Why lock application orientation mode?

Many applications have their User Interface (UI) designed to contain a lot of elements. To have these applications change their orientation (i.e. from portrait to landscape), it would mean that users will have a bad UI experience and also a lot of scrolling to deal with. A typical example of that case is games.

In these cases, app creators make a decision to visualize this information either vertically or horizontally, not both. Instead they prefer to “lock” orientation to one mode and optimize for it.

How to perform the configuration

There is no exposed API from React Native to achieve that (although there is one from ExpoKit), so in order to achieve our goal we can either configure it directly on the native apps or use third party packages that have been built to help with this purpose, like react-native-orientation.

This article is going to demonstrate how to perform the configuration in the native projects by ourselves; I’m a fan of discovering things in the native realm and delve deeper into them. And in this case it’s really easy and fast to configure it! Let’s see how to achieve this config, for both major platforms:


For Android platform all we need to do is navigate to AndroidManifest.xml file that lies inside android/app/src/main path and add the property android:screenOrientation with a value or portrait or landscape respectively. The property has to be added in xml element activity which is a child of application element.

Simply add it as shown below:

That’s it! Rebuild your project and your are good to go!


For iOS platform we need to open Xcode, and select the desired orientation modes from the Device Orientation section. As shown below:
1. Load the iOS part of your React Native project
2. Navigate to tab General from the horizontal menu
3. Go to down to Deployment Info section and check/uncheck the desired device orientation modes.

And you are set! Rebuild your project to verify that the changes are configured. And of course don’t forget to commit the code changes that were produced from this configuration setup:

What do you think?

What do you think about this article? Offer your perspective and ideas in the comments section below.

If you enjoyed this article, feel free to hit that clap button 👏 to help others find it.

About me

Hi there, I’m Tasos; a software engineer that loves web and currently works a lot with React Native and React. I’m the co-founder of Coded Lines software agency where we undertake end-to-end mobile & web projects with emphasis to in-app marketing. If it sounds what you are looking for, please contact me here: Thanks for stopping by :)



George Karboulonis for proof reading

Building With React Native

Technical posts about React Native. What issues we encountered while developing Math Warriors Android game and how we solved them.

Tasos Maroudas

Written by

Front End / Mobile Engineer currently working with React Native, React & TypeScript 😃 Part time blogger. Co-Founder of Coded Lines Ltd

Building With React Native

Technical posts about React Native. What issues we encountered while developing Math Warriors Android game and how we solved them.