How to Import an Image from Procreate Into Gms2
StyleFrame Team7 min read
To import a Procreate image into GameMaker Studio 2 (GMS2), export the artwork from Procreate as a PNG with the background layer hidden so the transparency survives. Move the file to your computer with AirDrop or iCloud Drive, then create a new sprite in GameMaker and import the PNG through the sprite import options, or try dragging the PNG in. For multi-frame animation, export a PNG per frame or per layer and import them as frames of a sprite, or as a single sheet image.
The rest of this guide covers the details that cause problems in practice: transparency, canvas size, color profile, frame handling, and pixel filtering.
Prepare the artwork in Procreate
Most import trouble starts on the canvas, not in GameMaker. A few minutes of setup avoids re-exporting later.
Hide the background color layer. Procreate's default canvas has a white background color layer. If you leave it on, your PNG exports as an opaque white rectangle with a character on it. Open the Layers panel and turn off Background color before exporting.
Choose the canvas size deliberately. Large canvases usually produce large sprites. A 4000 × 4000 px canvas is wasteful for a character that appears 200 px tall on screen. Decide your in-game display size first and draw at that size or at a clean multiple (2× or 4×) if you plan to scale down.
Match your color profile. If colors look slightly off after import, try creating the canvas with an sRGB profile instead. Set this when you create the canvas, because converting later can shift your tones.
Keep related frames the same size. If you're building an animation, use one canvas for all frames, or identical canvas dimensions across files, so the frames line up.
Leave padding where needed. If a character's pose extends to the canvas edge in one frame, leave equal margins around all frames. Cropping frames individually will shift the sprite's registration from frame to frame.
Export from Procreate
You have three useful export routes, depending on what you're making.
A single image or static asset
- Hide the Background color layer.
- Tap Actions → Share.
- Choose PNG (not JPEG, which has no alpha channel).
- Save to Files, AirDrop to your Mac, or send to a cloud folder.
PNG preserves transparency, which is what you want for sprites, props, UI elements, and anything that sits on top of a room background.
Individual layers as separate files
If you built a character in parts (body, arm, head) and plan to animate them separately in GameMaker, export each layer on its own. In the Share menu, look for the layer-based PNG option (PNG Files, under the Share Layers heading). Hide the background first. Each layer exports at full canvas size with transparent padding, so every part keeps its position relative to the others. That's convenient for reassembly, but you may want to crop parts later.
Frame-by-frame animation
If you animate in Procreate, check the export options in your version for a PNG sequence or individual frame images. Avoid GIF or MP4 for game assets. GIF limits you to a restricted palette with 1-bit transparency, and MP4 has no alpha channel at all. A PNG per frame keeps full color and soft edges.
Get the files onto your computer
GameMaker runs on desktop, so you need the exports on the machine where your project lives.
- AirDrop works well between an iPad and a Mac.
- iCloud Drive or another cloud folder works too. Save from Procreate to Files, then open the same folder on your computer.
Put the exports in a dedicated assets folder next to your project, such as /art_source/procreate_exports/. Keep your original .procreate files in a separate source folder. You'll want the originals for edits later.
Import the image into GMS2
Method 1: Create a sprite and import
- In the Asset Browser, create a new sprite.
- Name the sprite using your project's convention, for example
spr_player_idle. - In the Sprite Editor, look for an import option (an import button or the Image menu) and select your PNG.
- The image should appear as the first frame of the sprite.
Method 2: Drag and drop
Depending on your GameMaker version, you may be able to drag a PNG from your file explorer or Finder into the Sprite Editor, or onto the Asset Browser, to create a sprite from it. This is quick for single images. For anything you need to control carefully, Method 1 is easier to follow and repeat.
Importing multiple frames
For an animation exported as separate PNGs, import them all into the same sprite. If your version's import dialog lets you select multiple files, each may be added as its own frame, often in filename order. Name your exports with zero-padded numbers (walk_01.png, walk_02.png, ... walk_10.png) so the order doesn't jump from 1 to 10 to 2.
For a sprite sheet laid out as a horizontal strip, which is useful if you've assembled a sheet elsewhere, check your GameMaker version's documentation for how strip images are imported and split into frames.
Set the sprite up so it behaves
Importing is only half the job. Check these settings before you use the sprite in a room.
Origin. The origin is the point GameMaker uses for positioning, rotation, and scaling. For characters, move it to the feet or the center of mass, depending on your game logic. Setting it before you write code saves you from compensating with offsets later.
Collision mask. A detailed Procreate drawing with soft shadows or glows may create an oversized collision mask. Switch to a manual or simplified rectangle or ellipse mask if you want predictable collisions.
Cropping. If your Procreate canvas had lots of empty space, use GameMaker's cropping options to trim it, and keep the same crop across all frames. Verify your animation still lines up afterward.
Texture filtering. Pixel art that looks blurry in-game is often an interpolation setting, not an import problem. In your project's Game Options, look for a color interpolation setting and turn it off so scaled sprites stay sharp. For painterly, high-resolution art, leave smoothing on.
Troubleshooting common problems
White or black box around the sprite. The background layer was visible at export, or you exported JPEG. Re-export as PNG with the background hidden.
Sprite is huge in the room. The Procreate canvas was large. Either scale the instance in code or in the room editor, or re-export at a smaller size. Resizing in Procreate before final export is usually cleaner than scaling at runtime.
Colors look washed or too saturated. This may be a color profile mismatch. Recreate or convert the canvas to sRGB, then re-export.
Frames jitter during playback. Frames were cropped separately or the origin differs. Re-export with identical canvas sizes, then set one origin for the whole sprite.
Blurry edges on pixel art. Turn off interpolation in your project settings, and make sure your Procreate canvas was drawn at the intended pixel scale with no anti-aliased brush.
Layered .procreate or PSD files won't import. Procreate project files may not import into GameMaker directly. Export to PNG first, which is the reliable route.
Quick checklist
- Set the canvas to the right size and an sRGB color profile.
- Hide the Background color layer.
- Export as PNG, either a single image, layers, or one file per frame.
- Transfer the files to your computer and use consistent, zero-padded names.
- Create a sprite in GameMaker and import via the Sprite Editor (or drag and drop).
- Set the origin, collision mask, and cropping.
- Disable color interpolation if you're working with pixel art.
Following that order covers nearly every import issue artists hit when moving art from Procreate into GMS2, and it keeps your source files organized for revisions as the project grows.