# Changing viewport shading with python

I am trying to change the viewport shading to "RENDERED" with python, but I can't seem to figure out how.

It seems like bpy.types.SpaceView3D.viewport_shade = "RENDERED" should do it, but this doesn't work and doesn't even give a context error.

## 1 Answer

You have to specify which 3D view you want to access.

For example, this will iterate through all the areas in the current screen and set any 3D views to rendered shading:

import bpy

for area in bpy.context.screen.areas: # iterate through areas in current screen
if area.type == 'VIEW_3D':
for space in area.spaces: # iterate through spaces in current VIEW_3D area
if space.type == 'VIEW_3D': # check if space is a 3D view
space.viewport_shade = 'RENDERED' # set the viewport shading to rendered


## Update

Alternatively, you could also do the following:

import bpy

area = next(area for area in bpy.context.screen.areas if area.type == 'VIEW_3D')
space = next(space for space in area.spaces if space.type == 'VIEW_3D')
space.viewport_shade = 'RENDERED'  # set the viewport shading


Instead of looping through the whole bpy.context.screen.areas, etc, the next() method returns area as soon as it finds area.type == 'VIEW_3D'. This doesn't really affect performance for this example but it's a better way of achieving the same result. Plus, it looks neater!

• thanks! I guessed it was space compliant, because you can't activate it from anywhere but there. I just couldn't find a list of spaces. Thanks alot! – BlendingJake Oct 13 '14 at 3:18
• is there a way to do this in the game engine? say when you start the game it will always go into the specified shading instead of what ever shading you had when editing the game. – kanuki Dec 7 '18 at 9:57
• I'm getting 'SpaceView3D' object has no attribute 'viewport_shade' in 2.80. There is a shading attribute, but it is read-only. – Tomáš Hübelbauer Dec 19 '19 at 21:02
• blender.stackexchange.com/a/124427/68286 works - uses space.shading.type – Tomáš Hübelbauer Dec 19 '19 at 21:10