# Help Center

> Answers for setup, inventory, photos, exports, mobile, shortcuts, and troubleshooting.

GalleryPlanner help is organized around the main jobs users do in the app.

## Wall Setup

Start every project by defining the wall you're working with. Accurate dimensions ensure your on-screen layout maps to the real world.

- **Guided Setup**: Starting a new project on desktop or mobile can open **Guided Setup**, a five-step walkthrough that builds your first wall with you: pick a wall size and color, add frames, choose an Auto-Layout, then optionally add photos and let Smart Fill match them to frames. Prefer a ready-made arrangement? Apply a Starter Layout on the Frames step, and Guided Setup asks **Does this layout look right?** Choose **Yes** to keep it, **Choose another** to pick a different one, or **Try Auto-Layout** to rearrange the frames. Skip it anytime, replay it later from **Help → Guided Setup** on desktop or **Menu → Guided Setup** on mobile, or turn off *Show Guided Setup when creating a new project* in Settings. On desktop, a short Guided Tour also points out the main controls on your first visit, and **Help → Replay Guided Tour** shows it again.
- **Dimensions & Units**: Enter your wall width and height in inches or centimeters. Switch between imperial and metric at any time — the unit system is saved per project. Walls can be up to 50 ft (15 m) per side and 1,000 sq ft in total. **To change your wall size later:** on desktop, click an empty spot on the wall so nothing is selected, and the **Wall Properties** panel on the right shows the width and height. If that panel is hidden, click the small arrow tab on the right edge of the screen to bring it back. On mobile, tap **Edit** with nothing selected.
- **Wall Types**: Choose **Flat** for a standard wall, or **Staircase (Ascending / Descending)** for angled walls above a stairway. Set **Rise (%)** to how far the stairs climb across the wall, as a percentage of the wall's full height, measured at the bottom of the stairs (10–100).
- **Wall Objects (Pro)**: Put the real features of your wall on the canvas: Window, Door, Fireplace, TV, Light switch, Thermostat, Sconce, Shelf, Vent, Headboard, and Sofa presets, plus a Custom size for anything else. On desktop, open the Frames panel and click **Add Frame → Objects**; on mobile, tap **Library → Object**. Wall Objects draw as simple schematics on the canvas and in your exports, and they stay movable — but Auto-Layout and Smart Fill treat them as obstacles.
- **Wall Color**: Set the background color to match your actual wall paint. This helps you preview how frames and photos will look in context.
- **Add Wall (Pro)**: One wall doesn't have to be the whole plan. Click the **+ Add Wall** button next to your wall on the canvas — or right-click the empty workspace (press and hold on mobile) and choose Add Wall — to add another wall to the same project. Walls line up side by side with a shared floor line: drag a wall's label to reorder, rename it in Wall Properties, and deleting a wall sends its frames back to your Library without their photos (the photos stay in your Library, ready to place again) and removes any Wall Objects on it. Undo brings it all back.
- **Wall Textures**: Go beyond flat paint — preview your gallery on brick, shiplap, wood paneling, or even a furnished room scene, or upload a photo of your actual wall. With nothing selected, use the **Wall Texture** control in the Properties panel on desktop (or right-click the wall), or open the **Edit** sheet on mobile and scroll to **Wall Texture**. A starter set of textures is free; the full **Premium Wall Textures** collection and custom photos are Pro.
- **Clear Canvas**: Remove all frames from the canvas in one step — they return to your library, nothing is deleted, and it's undoable. On desktop, open **Wall Properties** with nothing selected; on mobile, tap **Edit** with nothing selected.

## Inventory & Frame Management

GalleryPlanner treats every frame as a physical item in your inventory, ensuring you never lose track of dimensions.

- **Adding Frames**: On desktop, open the Frames panel and click **Add Frame**; on mobile, tap **Library**. Pick a tab: **Common** for standard sizes, **Custom** to enter your own width, height, border, and mat, **Brands** for retailer presets, **Bulk** to paste a list or upload a CSV, **Layouts** for Starter Layouts, and **Objects** (Pro; **Object** on mobile) for Wall Objects. New frames usually land in your Library, ready to drag onto the wall or fill with Auto-Layout; on mobile, **Custom** can also **Add to Wall** directly. A Starter Layout goes straight onto the wall, and so does a Wall Object. Added the wrong one? Select it and press `Delete`; it's undoable.
- **Adaptive Grid Inventory**: The sidebar shifts between list and grid views to maximize screen space. Frames on the wall are clearly marked "Placed." Search, sort (newest, oldest, size), and filter (unplaced, placed, portrait, landscape, square, round) to find what you need. Click a placed row to select its matching frame(s) on the canvas. Frame previews sit on your wall color, and in list view each row also shows the frame color and border width, plus the mat opening and mat color for matted frames. In grid view, choose **Small**, **Medium**, **Large**, or **Extra Large** tiles from the **View Options** menu.
- **1:1 Manifest Logic**: Every frame is accounted for individually. Removing a frame from the wall returns it to your "Unplaced" inventory rather than deleting it.
- **Measuring Your Frames**: When you add a custom frame (**Add Frame → Custom** on desktop), **Width** and **Height** are the glass size: the size printed on the label (an "8×10 frame"), or the inside edge of the frame where the glass sits. Don't measure the outside edges. **Border** is the moulding width (the frame itself), and GalleryPlanner adds it around the outside, so an 8×10 with a 1" border takes up 10×12 on the wall. For a canvas, panel, or unframed print, enter the piece's actual size and set **Border** to 0. If the frame has a mat, turn matting on and enter **Opening W** and **Opening H**, the window you see the photo through. Spacing and the Hanging Guide use the full outside size.
- **Hanging Hardware**: Tell GalleryPlanner what's on the back of each frame so the Hanging Guide (Pro) can list where each nail goes. Select a frame and choose its **Hanging hardware** in the Properties panel on desktop, or tap **Edit**, then **Hardware** on mobile: **Sawtooth**, **Wire**, **D-ring**, **Two D-rings**, or **Adhesive** (no nail needed, so no measurements). For the others, enter the **Drop**, measured from the frame's top edge down to where the nail will catch (for wire, pull it tight toward the top first), plus the **Spacing** between Two D-rings. The hardware list shows a picture of each type and where to measure. If pulled-up wire reaches above the frame, tick **Above the frame**: the field then reads **Rise**, measured up from the top edge to the peak of the wire. If the numbers can't work for that frame, such as a drop longer than the frame is tall, a note under **Drop** or **Spacing** says so, and a drop more than halfway down the frame warns that it may tip forward. Setting hardware is free.
- **Matting**: Select a frame and check **Matted?** in the Properties panel on desktop, or tap **Edit** and turn on **Mat** on mobile, to add a mat. **Opening W** and **Opening H** are the window you see the photo through, and the glass size stays the same, so a mat never makes the frame bigger. Change the mat color in the same panel. Some retailer presets in **Add Frame → Brands** come with a mat already cut; turn it off if you plan to print full-bleed. Wall Objects don't have mats.
- **Labeling a Frame**: To name a frame (for example "Wedding Photo"), select it and type in the **Label** field at the top of the Properties panel on desktop, or tap **Edit** and use **Label** on mobile. Rename it anytime by changing the text.
- **Bulk CSV Import**: Open **Add Frame → Bulk** on desktop (or tap **Bulk** in the mobile Library sheet) to paste a list (e.g., "8×10, 11×14") or upload a CSV. Download the [CSV template](/examples/gallery-import-template.csv) to fill in dimensions, color, mat color, label, and quantity. The columns match the Pro Shopping List export, so you can round-trip an entire frame inventory between projects.
- **Brands: Retailer Frame Presets**: Planning around store-bought frames? Open **Add Frame → Brands** on desktop (or tap **Brands** in the mobile Library sheet) and pick a frame family. Every preset carries the real glass size and moulding width from the retailer's published specs, plus the mat opening when the frame comes with a mat, so an IKEA RÖDALM 12×16 lands in your library as the 12¾×16¾" frame it actually is, with a mat cut for an 8×10 print. IKEA is free; Pottery Barn, West Elm, and CB2 presets are part of Pro. Presets that come with a mat add with it — turn it off in Properties if you plan to print full-bleed. Sizes are US catalog data for planning convenience; GalleryPlanner isn't affiliated with these brands.
- **Starter Layouts**: Start from one of 100+ curated wall arrangements, then customize every frame. Free collections cover Essentials, Organic, Architectural, and Salon; Pro adds Curated Finds, The Townhouse Collection, and Editorial Mix. Filter by category, frame count, shape, or free vs. Pro to narrow the list. Layouts use your frame color from *Settings → Frame Defaults*. On a staircase wall, the layout lands above the stairs, centered left to right. On a flat wall with Pro, it lands with its middle at your **Eye level** setting, unless that would crowd the ceiling, run past the floor, or cover a Wall Object. If the wall already has frames, GalleryPlanner asks what to do first. When the frames came from a Starter Layout, choose **Swap layout** to put the new layout where the old one was. Only the most recently applied layout is swapped; every other frame stays put. When the wall has frames you placed yourself, choose **Replace my frames** to delete them and put the new layout where they were (deleted frames don't go back to your Library, but **Undo** restores them); Wall Objects aren't touched. Either way, your photos move into the new frames where they fit, and **Add alongside** keeps everything and adds the new layout too. On desktop, open *Frames → Add Frame → Layouts*; on mobile, tap *Library → Layouts*. For worked examples with frame sizes and hanging tips, see our [example layouts](/examples).
- **Locking & Grouping**: Lock frames to prevent accidental edits. Group frames so they move, lock, and delete together. Available from the right-click menu, floating toolbar, or keyboard shortcuts.
- **Aesthetics & Customization**: Label frames (e.g., "Wedding Photo"), adjust frame borders (they grow outward, so the glass size stays the same), customize frame and mat colors, and use Round/Oval frame shapes.

## Photo Management

Import, drag-and-drop, cropping, and library management.

- **Adding Photos & File Formats**: On desktop, open the Photos panel and click **Add Photos**, or drag image files straight onto the canvas. On mobile, tap **Library → Photos**, then **Add Photos** to pick from your camera roll. Supported photo file formats are JPG, PNG, WebP, GIF, and HEIC/HEIF. To put one on the wall, drag it onto a frame, or let Smart Fill place your photos for you. Your photos stay on your device and are never uploaded.
- **Masonry Photo Library**: A high-efficiency masonry grid for managing all your uploaded photos. Adjust the thumbnail size from small to extra-large.
- **Drag & Drop Workflow**: Drag image files from your desktop onto the canvas or directly onto a frame to import and place them. You can also drag from the photo library sidebar. Photos are never uploaded to our servers.
- **Smart Fill**: Let the AI engine analyze your photo library for composition, color, and resolution, then auto-place the best matches into your frames. Toggle **Wall photos only** to reshuffle photos already on your wall instead of pulling in new candidates from your full library.
- **Whole-Wall Balance (Pro)**: A Smart Fill option that spreads people, bright spots, and warm tones evenly across the whole arrangement — instead of judging each frame on its own. Check **Whole-wall balance** in the Smart Fill options before you generate.
- **Removing a Photo**: To take a photo out of a frame, select the frame and click **Remove Photo** in the Photo panel on desktop, or tap **Edit** and then **Remove Photo** on mobile. On desktop you can also right-click the frame and choose **Remove Photo**. The frame stays on the wall, the photo stays in your photo library, and you can undo it. To delete a photo from your library entirely, select it in the Photos panel and use the delete button.
- **Fit: Crop, Rotate, Reset**: Scale, pan, and rotate images within their frames using the **Fit** controls in the Photo panel. Hit **Reset Crop** to recenter at 100% in the mat opening. **Advanced Photo Cropping** (Pro) adds a dedicated crop overlay for stronger composition control.
- **Levels: Brightness, Contrast, Midtone**: Per-photo tonal sliders so each photo reads correctly on the wall. Tap **Auto Level** (Pro) to set all three automatically based on the photo's visible cropped region. On mobile, these live in the **Levels** tab of the Edit sheet.
- **B&W Photo Conversion (Pro)**: Turn any photo black & white in one click for a classic, cohesive look — and restore the color anytime; your original photo is never changed. On desktop, select a frame with a photo and click **Convert to B&W** in the Photo panel; on mobile, tap **B&W** in the Edit sheet.

## Workspace Interaction

Canvas controls, layout tools, and editing behavior.

- **Canvas control bar**: On-canvas controls for zoom (with 1:1 and Fit presets), background grid toggle, Eye Level guide, and snap-to-grid toggle (the magnet icon), plus a Spacing Guides toggle on phones. On desktop, the Settings menu in the header has the same toggles plus Frame Labels, Spacing Guides, and Snap to Guides, and **All settings…** at the bottom opens the full Settings window. On phones, they are in Settings → Canvas.
- **Spacing Guides**: While you drag a frame, a group, or a selection, labels show the gap to the nearest frame on each side, or to the wall edge. Gaps that match another gap on the wall turn blue, and blue dashed lines show edges and centers that line up. The frame snaps into equal spacing or into line when it gets close; on phones you feel a light tick. With a mouse, hold Shift to switch guide snapping the other way for that drag (off if Snap to Guides is on). Turn Spacing Guides or Snap to Guides off in Settings.
- **Selection & Alignment**: Click to select, Shift-click to multi-select, or click-drag a marquee. A single frame aligns to the wall edge or center; multiple ungrouped frames align relative to each other (left, center, right, top, middle, bottom). **Center a group of frames:** Select the frames and group them (`Ctrl` + `G`). Then use the alignment tools to center the entire group on the wall without changing its internal spacing. Select 3 or more frames to also use **Distribute** — equalize the horizontal or vertical gaps between them in one click. On mobile, select a frame, then tap **Select Multiple** to add more to the selection — a status bar shows the count with **Group**/**Ungroup** and **Done**. On mobile, Align and Distribute are in the floating toolbar above the selection.
- **Context Menu**: Right-click any frame for Cut/Copy, Duplicate, Lock/Unlock, Group/Ungroup, Auto-Fill, Rotate, and Delete. When the frame has a photo, the menu also offers Crop Photo (Pro), Rotate Photo, and Remove Photo. Right click the wall to change the background wall texture, paste cut/copied frames, quickly add standard frames, center all frames at eye-level (Pro), or select all frames.
- **Floating Toolbar & Resize Mode**: Selecting one or more frames reveals a toolbar above the selection for quick access to common actions. **Rotate** turns a frame between portrait and landscape (or press `R`). Select a single frame and enable resize mode from the toolbar to drag any corner or edge handle directly on the canvas. *Resize mode requires Pro.* Overlapping frames? Use **Order** in the toolbar to **Bring to Front** or **Send to Back**.
- **Layout Zones (Pro)**: Draw rectangular zones on your wall to constrain where Auto-Layout places frames. Useful for targeting a specific area of a large wall.
- **Eye Level Guide**: A reference line at standard hanging height. On a staircase wall it runs parallel to the stairs, at that height above them. Toggle it from the canvas control bar. On flat walls, Center at Eye Level (Pro) snaps your selection to this guide automatically.
- **Canvas Icons & Lines**: What the marks on your wall mean. **Dashed line across the wall:** the Eye Level Guide, a reference at standard hanging height (it follows the stairs on a staircase wall) — toggle it from the canvas control bar. **Dashed rectangle on the wall:** a Layout Zone, which keeps Auto-Layout placing frames inside it. **Dashed box around a frame:** the resize outline while resize mode is on. **Yellow or red triangle with an exclamation point on a photo:** a low-resolution warning — the photo may look soft (yellow) or blurry (red) if printed at that frame size. It looks fine on screen; try a smaller frame, zoom the photo out, or use a higher-resolution photo. See the [Print Resolution Guide](/learn/print-resolution-guide). **Amber outline or STAGED badge:** a staged frame parked off the wall (see Staged Frames).
- **Show on wall**: Can't remember where a photo ended up? On desktop, right-click a photo in the Photos panel and choose **Show on wall** — the canvas jumps to the frames using it. On mobile, tap a placed photo in the Library sheet (with nothing selected) and the wall zooms to its frame.
- **Staged Frames**: A frame sitting on the workspace but not fully on the wall gets an amber outline — plus a small **STAGED** badge when the frame is big enough to fit it (Wall Objects too). Think of it as your "maybe" pile — park frames beside the wall while you decide, and Auto-Layout can pull them in when you're ready.

## Auto-Layout Engine

Don't suffer from "blank wall syndrome." Let the algorithms do the heavy lifting.

- **Curated**: Lays out your frames like a real gallery wall, using arrangements based on real-life walls, and places the result near eye level. On a staircase wall, it centers the result above the stairs instead, and staircase-style layouts come first, turned to climb with the stairs. *Requires Pro.*
- **Masonry**: Tightly packed, organic grid.
- **Grid**: Strict, uniform alignment.
- **Skyline**: Bottom-aligned rows, great for mantels and ledges.
- **Center Out**: Artistic, center-outward flow.
- **Organic**: A relaxed, asymmetrical cluster that feels collected over time, grown as one connected group that keeps to your Spacing.
- **Tidy Up**: Snaps your existing arrangement into cleaner alignment without rearranging.

Dial in the results before you generate:

- **Shape (Masonry only)**: Pick **Ultra-wide**, **Wide**, **Balanced**, or **Tall** to bias Masonry toward wider rows or taller columns — handy for matching your wall's proportions.
- **Included Frames**: Choose which frames Auto-Layout arranges: **Placed Only**, **Placed + Staged** (the default), or everything — including frames still waiting in your inventory.
- **Require placing all frames**: Tick **Require placing all frames** when every included frame has to go on the wall. If they can't all fit, Auto-Layout tells you right away instead of offering layouts that leave some out. It's always on with **Placed Only**.
- **Layout priority**: When not every frame fits, choose what to favor: **Fit more frames** places as many as it can, while **Balanced** and **Best looking** may leave out optional staged or inventory frames for a nicer result. Frames already on your wall are always kept. Tidy Up and Curated don't use this setting.
- **Pinned Auto-Layouts (Pro)**: Found a keeper? Tap the pin on any result to save it to **Pinned Layouts**, then keep experimenting — you can come back and reapply a pinned layout while you work.

## Saving & Projects

Your work is saved automatically on your device. For portable backups and cross-device transfer, use .gwall files.

- **Auto-Save**: Changes are saved in your browser on this device automatically. Your layout, frames, photos, and analysis data survive restarts, but not clearing browser data. Nothing is backed up for you, so export a .gwall copy of anything important.
- **Import / Export Project**: Export Project saves a portable .gwall file containing your entire project: every wall, frame inventory, photos, and analysis data. Import Project opens it in any browser, on any device. The current version opens .gwall files from any older version, but files exported by the current version may not open in older versions of the app.
- **Export All Projects (Pro)**: Back up everything in one step — every project is saved as its own .gwall file. On desktop, open the **Project** menu → **Export All Projects**; on mobile, tap your project's name at the top of the screen, then **Export All Projects**.
- **Import Projects (Pro)**: Restore a full backup or move to a new device: import several .gwall files at once and each one becomes its own project. On desktop, open the **Project** menu → **Import Projects**; on mobile, tap your project's name, then **Import Projects**.
- **Backup Reminders**: Your projects live on this device — never on our servers. So GalleryPlanner reminds you from time to time to save a portable copy, and you can export right from the reminder: **Export Project**, or **Back Up Projects** with Pro to export everything at once.
- **If a Project Goes Missing**: GalleryPlanner is local-first: your projects and photos are stored in this browser on this device, never on our servers. That means two things worth knowing. First, projects don't sync across computers or browsers — Pro follows your account for access to features, not your project data. Second, in Safari on iPhone and iPad, the browser can clear storage for sites you haven't visited in a while, which can erase projects with no warning. **Export Project** is the fix for both: it saves a portable copy as a .gwall file you can re-import on any device, so your work never lives in just one place.
- **Undo & Redo**: Up to 50 levels of undo/redo per project. Use `Ctrl`+`Z` to undo and `Ctrl`+`Shift`+`Z` to redo. On mobile, use the Undo and Redo buttons. History is cleared when you close the tab or app.
- **Multi-Project Editing (Pro)**: With GalleryPlanner Pro, you can fully edit multiple projects, so you can keep separate spaces — or competing ideas — going at once. Planning several walls in one space? That's Multi-Wall Projects, below.
- **Multi-Wall Projects (Pro)**: Keep a whole room in one plan: every wall in a project shares one photo library, undo covers them all, and exports include every wall — the Hanging Guide gets a section per wall. Your first wall is always free; adding a second wall and beyond requires Pro.
- **Duplicate Project (Pro)**: Want to try a different direction without losing what you have? Duplicate makes a complete copy of your current project. On desktop, open the **Project** menu → **Duplicate Project**; on mobile, tap your project's name at the top of the screen, then **Duplicate**.

## Exporting & Sharing

When your layout is ready, export what you need for installation day. On desktop use the Export menu; on mobile use the Share tab.

- **Snapshot Image**: Capture your whole workspace — every wall — as an image. The free snapshot is a standard-resolution JPG with a small watermark. The 4K snapshot (Pro) exports a high-resolution watermark-free PNG.
- **Hanging Guide PDF (Pro)**: A print-ready PDF with a Measurement Schematic of your wall, numbered frames, precise spacing measurements, and a dimensions table — each wall in your project gets its own section. Set each frame's **Hanging hardware** and the guide also lists where each nail goes, measured from the wall's left edge and up from the floor (or from the stairs, on a staircase wall), and marks every nail on the Measurement Schematic, with its position beside it where there's room. Everything you need to hang with confidence.
- **Shopping List (Pro)**: A spreadsheet-ready list of all your frames grouped by size, including dimensions, colors, and matting details. Great for ordering frames online or taking to a store.
- **Print-Ready Photos (Pro)**: Export all your photos cropped exactly as they appear in their frames, at high resolution. Send straight to a print lab.
- **Export Bundle (Pro)**: Pick any mix of the Hanging Guide, Shopping List, Print-Ready Photos, 4K Snapshot, and Export Project (a .gwall file), and download them together in one step. Your selections are remembered for next time.

## Account & Pro Access

A free GalleryPlanner account is what carries Pro bought on the web. Create it inside GalleryPlanner, with the same email you used at checkout.

Creating an account takes about a minute:

- **1. Click Sign Up**: Open [GalleryPlanner](/app). On desktop, click **Sign Up** in the top-right corner, next to **Upgrade to Pro**. On mobile, open **Menu** and tap **Sign Up**. If you've had Pro on this browser before, you'll see **Sign In** instead; use it to get back into your account.
- **2. Enter Your Email, or Use Apple, Google, or Microsoft**: The quickest way: click the **Apple**, **Google**, or **Microsoft** button at the top and sign in with that account. There's no code to enter, and you're done. Otherwise, type your email address, check the box to agree to the Terms of Service and Privacy Policy, and click **Continue**. Either way, if you already bought Pro, use the same email you entered at checkout.
- **3. Enter the Code**: If you signed up with your email, we send you a six-digit code. Enter it and click **Continue**, and you're signed in. No code after a minute or two? Check your spam folder, or click **Resend**.

Bought Pro on the web? Here is how it reaches your account:

- **Use the Same Email You Paid With**: Pro bought on the web is saved under the email address you entered at checkout. Create your GalleryPlanner account (or sign in) with that same email, and Pro turns on automatically. Signing in with Apple, Google, or Microsoft works too, as long as it uses that same email. With Sign in with Apple, choose **Share My Email**: if you hide your email, Apple gives us a private relay address that won't match the email you paid with.
- **Lemon Squeezy Accounts Are Separate**: Lemon Squeezy processes our web payments and sends your receipt. They may also let you sign in on their site to see your orders. That is a Lemon Squeezy account, not a GalleryPlanner account, and signing in there **does not give you Pro**. To use Pro, create your account inside GalleryPlanner using the steps above.
- **Pro Isn't Showing Up?**: Check that you're signed in: the top-right corner shows your profile icon instead of **Sign Up** or **Sign In**. Then check that your account uses the same email you paid with. Already made an account with a different email? Email us and we'll move Pro over. Still stuck? Email us from the address you used at checkout and we'll sort it out.

Done with GalleryPlanner?

- **Delete Your Account**: On a computer, click your profile picture in the top-right corner and choose **Delete account**. On a phone or tablet, open **Menu**, tap the **Signed in as** card, and choose **Delete account**. Your account settings open on the **Security** page: scroll to the bottom, click **Delete account** there, and confirm. This ends Pro on your account, including any Pro Pass saved to it. Your projects and photos stay on your device.

## Mobile Experience

GalleryPlanner on phones and tablets is optimized for planning on the go with touch-first interactions and a streamlined interface.

- **Touch-Optimized Gestures**: Single finger pans the wall. Pinch to zoom. Tap a frame to select it, drag selected frames immediately, and hold an unselected frame briefly to pick it up. Long-press a selected frame to open the context menu. Long-press a frame in Library to drag it directly onto the canvas; long-press a photo in Library to drag it onto any frame. Or tap an unframed photo in Library and then tap a frame to place it.
- **Get the App**: Supported browsers can install GalleryPlanner for quicker launch and a standalone app feel (on iPhone and iPad, use **Add to Home Screen** in Safari). A GalleryPlanner app for iPhone is coming soon.
- **Seamless Handoff**: Start planning on your phone and finish on your desktop (or vice versa) using **Import / Export Project**. See [Saving & Projects](/help/saving) for details.

- **Quick Zoom**: Double-tap a frame to zoom in; double-tap the wall to switch between the whole wall and 100%.
- **Manage Library**: Tap **Select** in the Library sheet header to enter manage mode for bulk actions; tap **Done** to exit.
- **Landscape View**: Rotate your phone for a wider canvas.

## Shortcuts Reference

Keyboard commands for faster editing.

Desktop only. On Mac, use ⌘ instead of Ctrl and ⌥ instead of Alt.

| Category | Shortcut | Action |
| --- | --- | --- |
| **View** | Scroll / Trackpad | Pan workspace |
|  | Right-Click + Drag | Pan workspace |
|  | `Ctrl` + Scroll | Zoom in / out |
|  | `Ctrl` + `+` / `−` | Zoom in / out |
|  | `Ctrl` + `0` | Fit wall / 100% |
|  | `+` / `−` (crop mode) | Zoom the photo or wall texture |
|  | `0` (crop mode) | Reset the crop |
|  | `#` | Toggle background grid |
|  | `S` | Toggle snap-to-grid |
| **Selection** | `Ctrl` + `A` | Select all (unlocked frames) |
|  | `Shift` + Click | Toggle frame in/out of selection |
|  | Click + Drag (empty area) | Marquee selection |
|  | `Escape` | Deselect all |
| **Edit** | `Ctrl` + `C` / `X` / `V` | Copy / Cut / Paste |
|  | `Ctrl` + `D` | Duplicate selection |
|  | `Ctrl` + Drag | Quick duplicate and move |
|  | `R` | Rotate selected frame 90° |
|  | `Delete` / `Backspace` | Delete selection |
|  | `Arrows` | Nudge 1 px (`Shift` for 10 px) |
|  | `Alt` + `Arrows` | Nudge 5 px |
|  | `Shift` + Drag frame | Invert grid and guide snapping while dragging |
|  | `Ctrl` + `Z` | Undo |
|  | `Ctrl` + `Shift` + `Z` / `Ctrl` + `Y` | Redo |
| **Organize** | `Ctrl` + `G` | Group selected frames |
|  | `Ctrl` + `Shift` + `G` / `Ctrl` + `U` | Ungroup |

## Good To Know
- Projects and photos stay local by default
- Pro is tied to your account, so it follows you to any browser where you sign in
- Use Import / Export Project to move a project between devices as a .gwall file
- If something looks off, the Help Center and support email (support@gallery-planner.com) are the fastest next step

## FAQ
- **Is GalleryPlanner really free?** Yes. Core planning is free forever with all creative tools. Pro adds extra features for serious planners — see What is GalleryPlanner Pro? for the full list.
- **Where are my photos stored?** On your device, in your browser. We never upload your images to a server, so your photos stay private. Nothing is backed up for you, so use Export Project to save a .gwall copy of important projects.
- **Can I use GalleryPlanner on my phone, tablet, or desktop?** Yes. GalleryPlanner runs in any modern browser on desktops, tablets, and phones. A GalleryPlanner app for iPhone is coming soon.
- **How do I print my layout?** Use Export (desktop) or the Share tab (mobile) to generate a print-ready Hanging Guide (PDF) with precise measurements. This feature requires GalleryPlanner Pro.
- **What if I switch computers or browsers?** Use Export Project to create a portable .gwall copy, then Import Project in any browser, on any device. The file includes all your walls, plus your frame inventory, photos, and analysis data. On mobile, tap the project name to open Project Switcher for Export/Import. One heads-up: files exported by the current version may not open in older versions of the app — if an import fails on another device, refresh GalleryPlanner there and try again.
- **What is a .gwall file?** A .gwall file is a portable project copy created by Export Project. It packages your entire project — every wall, your frame inventory, photos, and Smart Fill analysis data — into a single file you can store in Files, iCloud, Drive, Dropbox, or anywhere else, or share with another device. Import Project opens it on any device, in any browser. Compatibility is one-way: the current version opens .gwall files from any older version, but files exported by the current version may not open in older versions of the app.
- **How do I back up all my projects?** Your projects live in this browser on this device — nothing is uploaded to our servers, and backups are up to you. Pro users can use Export All Projects to save every project as .gwall files in one go, and Import Projects to restore them later. On the free plan, Export Project backs up your current project. Find these in the Project menu (desktop) or by tapping the project name to open Project Switcher (mobile). GalleryPlanner also shows an occasional reminder so your backup never falls behind.
- **Why did my project disappear?** Projects are saved in your browser on your device, not on our servers. So nothing syncs between browsers or devices, even on Pro (Pro only follows your account for access to features, not project data). In Safari on iPhone or iPad, the browser can also clear site storage if you haven't opened GalleryPlanner in a while, which can erase saved projects. The fix is Export Project: it creates a portable backup .gwall file you can re-import anywhere, so your work never lives in just one place.
- **How do I undo a change?** Press Ctrl+Z (or ⌘Z on Mac) to undo, and Ctrl+Shift+Z (or ⌘Shift+Z) to redo. On mobile, use the Undo and Redo buttons. GalleryPlanner keeps up to 50 levels of undo per project until you close the tab or app.
- **How do I change my wall size?** On desktop, click an empty spot on the wall so nothing is selected, then edit the width and height in the Wall Properties panel on the right. If the panel is hidden, click the small arrow tab on the right edge of the screen to open it again. On mobile, tap Edit with nothing selected.
- **Can I change between inches and centimeters?** Yes. You can switch between imperial (inches) and metric (centimeters) at any time in Wall Properties. Your preferred unit system is saved per project and remembered for new projects.
- **What are Wall Objects?** Wall Objects (Pro) put the real features of your wall on the canvas so your frames plan around them. There are 11 presets (windows, doors, fireplaces, TVs, light switches, thermostats, sconces, shelves, vents, headboards, and sofas), plus a custom size for anything else. On desktop, open the Frames panel, click Add Frame, then pick the Objects tab. On mobile, tap Library, then Object. Each object appears as a simple schematic drawing on the canvas and in exports.
- **How do I group frames together?** Select two or more frames, then right-click and choose Group, or press Ctrl+G (⌘G on Mac). Grouped frames move, lock, and delete together. To ungroup, right-click and choose Ungroup, or press Ctrl+Shift+G (⌘Shift+G).
- **What does the STAGED badge on a frame mean?** The amber outline means a frame is on the canvas but not fully on the wall — it's parked to the side, or hanging over the edge, while you decide where it goes. Frames big enough to fit it also show a small STAGED badge. Drag the frame fully onto the wall and the cue disappears. Wall Objects show the same cue. Auto-Layout includes staged frames by default, so nothing you've parked gets left out.
- **What is Guided Setup?** Guided Setup is a five-step walkthrough that builds your first wall with you: pick a wall size and color, add frames, choose an Auto-Layout, then optionally add photos and let Smart Fill match them to frames. It opens automatically when you start a new project on desktop or mobile, unless you've turned it off in Settings. Skip it anytime, replay it later from the Help menu on desktop or the Menu on mobile, or turn off future auto-launches in Settings.
- **Can I plan with IKEA frames or other store-bought frames?** Yes. The Brands tab in Add Frame has presets for IKEA, Pottery Barn, West Elm, and CB2 frames with the real outer size built in, plus the mat opening when the frame comes with a mat, so what you plan matches what arrives. IKEA presets are free; the other three brands are part of Pro. Our IKEA frame size guide (/learn/ikea-frames-gallery-wall-sizes) lists every current US size.
- **Do I need to create an account?** No. You can plan without an account. Buying Pro uses your account, so Pro follows you to any browser.
- **How do I delete my account?** On a computer, click your profile picture in the top-right corner and choose Delete account. On a phone or tablet, open the menu, tap the Signed in as card, and choose Delete account. Your account settings open on the Security page: scroll to the bottom, click Delete account there, and confirm. This ends Pro on your account, including any Pro Pass saved to it. Your projects and photos stay on your device. If you signed in with Apple, you can also remove GalleryPlanner from your Apple Account: on iPhone, Settings → your name → Sign in with Apple; on the web, account.apple.com → Sign-In & Security → Sign in with Apple.
- **What happens if I buy a Pro Pass while one is still active?** Nothing is lost. Your new pass stays unactivated, and the Pro dialog shows it as ready. Once your current pass ends, activate it from the Pro dialog, or just use a Pro feature and it activates automatically.
- **Can I plan for multiple walls at once?** Yes. With Multi-Wall Projects (Pro), a single project can hold more than one wall — a hallway plus a staircase, or a whole room — all sharing one photo library. Free includes one editable wall per project; Pro lets you add as many walls as you need (projects with more than one wall are view-only without Pro). Exports cover every wall in the project — the Hanging Guide gives each wall its own section. Multi-Wall Projects is separate from Multi-Project Editing, which lets Pro users edit several projects.
- **Can I copy an existing project?** Yes. Duplicate Project (Pro) creates a complete copy of your current project — walls, frames, and photos — with "(copy)" added to the name, and opens it right away. On desktop, open the Project menu and choose Duplicate Project. On mobile, tap the project name to open Project Switcher, then tap Duplicate. It's a safe way to try a bold rearrangement without touching the original.
- **What exactly is Smart Fill?** Smart Fill is an AI-powered engine that analyzes your photo library for composition, color, and resolution to place the best matches into your frames automatically. It is available on both free and Pro plans. Pro includes the Whole-wall balance feature. Toggle "Wall photos only" to reshuffle just the photos already on your wall instead of pulling new candidates from your library.
- **How do I measure for a staircase wall?** In Wall Properties, select a Staircase wall type (Ascending or Descending), then set the Rise percentage to match your measured slope.
- **How do I adjust brightness and contrast on a photo?** Select a frame with a photo, then open the Photo panel (desktop) or the Levels tab of the Edit sheet (mobile). Use the Brightness, Contrast, and Midtone sliders to balance how each photo reads on the wall. Pro users can tap Auto Level for one-click tonal optimization based on the visible cropped region of the photo.
- **How do I import a lot of frames at once?** On desktop, open the Frames panel, click Add Frame, then pick the Bulk tab to paste a comma- or line-separated list of dimensions (e.g. "8×10, 11×14, 16×20"), or download the CSV template, fill in dimensions, color, mat color, label, and quantity, and upload it. On mobile, tap Library, then Bulk. The CSV columns match the Pro Shopping List Export, so you can round-trip a frame inventory between projects.
- **How do I hide the frame size labels?** On desktop, open Settings in the header and click Frame Labels. On a phone, open Settings from the menu and turn off Frame Labels in the Canvas section. It hides or shows the dimension labels on empty frames and the size label that appears under a selected frame with a photo, so they don't distract from the layout.
- **How do I reset a photo back to its default crop?** Select the frame, then click Reset Crop in the Photo panel on desktop, or tap Reset on the Fit tab of the Edit sheet on mobile. The photo recenters at 100% zoom relative to the mat opening.

## More
- [What Is GalleryPlanner?](/what-is-galleryplanner): What the planner does, who it is for, and how it differs from generic design tools.
- [Pricing](/pricing): Free vs Pro, pricing, and what Pro includes.
- [Privacy Policy](/privacy): Local-first data stance.
- [Terms of Service](/terms): Terms of service.