What texture balls are and why you'd import them

A texture ball in Substance Painter is a spherical preview object that shows you how a material looks under realistic lighting. Instead of painting on a flat canvas, you paint on a sphere so you can see how your texture behaves across curves, how light hits it from different angles, and whether your normal maps and roughness settings actually work together. When you import a texture ball, you're adding a new 3D model to Substance Painter's library of preview shapes.

Most people use the default sphere that comes with Substance Painter, but custom texture balls let you preview materials on specific shapes — a car hood, a character's skin, fabric folds, or anything else you're actually texturing. If you've downloaded a texture ball file from another artist or a resource site, you need to import it into Substance Painter before you can use it.

Key Takeaways

  • Texture balls are 3D preview objects that show how your materials look under lighting, and custom ones must be imported as .obj or .fbx files.
  • The import process happens in Substance Painter's Preferences window under the Display Textures section, not through a File menu.
  • Your texture ball file needs to be a single mesh with a single UV map, or Substance Painter will reject it or display it incorrectly.
  • After importing, the new texture ball appears in the viewport's preview shape dropdown menu and stays available for future projects.

Prepare your texture ball file before importing

Before you open Substance Painter, check that your texture ball file is in a format Substance Painter accepts. The software reads .obj and .fbx files. If you downloaded a texture ball as a .blend file (Blender), .max file (3ds Max), or any other format, you'll need to export it as .obj or .fbx first using the original software.

Open the file in its native program, go to File > Export As, and choose either OBJ or FBX from the format dropdown. Save it somewhere you can find it — your Downloads folder or a dedicated textures folder works fine. The file size should be small, usually under 5 MB. If your texture ball file is larger than that, it may contain unnecessary geometry or textures that will slow Substance Painter down.

Check that the model is a single mesh, not multiple separate objects grouped together. If it's made of multiple pieces, Substance Painter may import only the first one or display it incorrectly. If you need to combine pieces, open the file in your 3D software, select all objects, and use the merge or join command before exporting again.

Open Preferences and navigate to the Display Textures section

Launch Substance Painter. In the top menu bar, click Edit (on Windows) or Substance Painter (on Mac), then select Preferences. A Preferences window will open with a list of categories on the left side.

Scroll down the left panel until you see Display Textures. Click on it. The right side of the window will now show options for texture ball management, including a list of currently available texture balls and an Import button.

Import the texture ball file

In the Display Textures section, look for the button labeled Import or a plus icon next to the texture ball list. Click it. A file browser window will open. Navigate to wherever you saved your texture ball file (.obj or .fbx), select it, and click Open or Import.

Substance Painter will process the file for a few seconds. If the import succeeds, the texture ball will appear in the list with a preview thumbnail. If the import fails, Substance Painter will show an error message. Common reasons for failure include the file being in an unsupported format, the file containing multiple meshes that Substance Painter couldn't merge, or corrupted geometry in the model itself.

If you see an error, go back to your 3D software, check that the model is a single clean mesh with no overlapping faces or broken normals, export it again, and try importing once more.

Use your imported texture ball in the viewport

Close the Preferences window. Open a project in Substance Painter or create a new one. In the top right of the 3D viewport, you'll see a small sphere icon or a dropdown menu that controls which preview shape is displayed. Click it.

Your newly imported texture ball will appear in the list alongside the default sphere, cube, and other built-in shapes. Select it. The viewport will now show your custom texture ball instead of the default sphere, and any materials you paint will display on that shape in real time.

The imported texture ball stays in Substance Painter's library permanently. You don't need to import it again for future projects — it will always be available in that dropdown menu.

Troubleshoot common import problems

If your texture ball imports but looks distorted, stretched, or has missing parts, the issue is usually with the UV map. Substance Painter needs the model to have a valid UV layout so it knows where to place textures. Open the file in your 3D software, check that the model has a UV map assigned, and make sure the UVs don't overlap or extend outside the 0 to 1 space. Export again and reimport.

If the texture ball imports but doesn't appear in the viewport dropdown, try restarting Substance Painter. Sometimes the software needs to refresh its interface to show newly added items. If it still doesn't appear after a restart, delete the imported file from the Preferences list and try importing a different version of the model.

If you're importing a texture ball that another artist created and it looks correct in their screenshots but wrong in your copy of Substance Painter, check your software version. Older versions of Substance Painter may not support certain model features or file formats. Update to the latest version and try again.

Frequently Asked Questions

Can I import a texture ball that has multiple separate objects?

Substance Painter works best with a single mesh. If your texture ball is multiple objects, merge them in your 3D software before exporting. Select all objects, use the join or merge command, then export as a single .obj or .fbx file.

What's the difference between importing a .obj and a .fbx texture ball?

Both formats work in Substance Painter. OBJ is simpler and more widely compatible, while FBX can store more information like rigging or animations (though Substance Painter ignores those). For a static texture ball, either format is fine. Use whichever one you have.

Do I need to delete the default texture balls before importing a custom one?

No. Your imported texture ball adds to the existing list — it doesn't replace anything. You'll have access to both the default shapes and your custom ones in the viewport dropdown.

Will my imported texture ball work in other projects?

Yes. Once you import a texture ball, it stays in Substance Painter's library and is available in every project you open. You don't need to reimport it.

What should I do if the import button is grayed out?

The import button may be disabled if Substance Painter doesn't recognize a valid texture ball file in your current selection. Make sure your file is in .obj or .fbx format and that it contains a valid 3D model. If you're unsure, try exporting the model again from your 3D software and make sure the export settings are set to include geometry.