Projects and gallery
Build Showcase projects and gallery media.
Quick start
- Sign in, open
My Portfolios, and click Edit on a portfolio to open/portfolios/edit/[pid]. - In the sticky jump nav, click Career — Projects (
section-projects) sits at the top of that group. Click Add, enter a Name and a Description, then Save. - Optional: in the same Add Project / Edit Project panel, attach Primary media (one image or video) from upload or your media library, then Save.
- Click Showcase in the jump nav to reach Gallery (
section-gallery). Click Add Media, set a Media title, attach media, then Save. - Confirm your new project card and gallery tile appear in the editor lists.
Editor chrome and jump labels: Portfolio editor overview. Services, testimonials, contact, embeds, and blocks are covered in Extra sections.
Deep dive
Where Showcase work lives
On /portfolios/edit/[pid], this guide covers the two media-heavy lists:
| Section | Anchor | Jump nav | Role |
|---|---|---|---|
| Projects | section-projects | Career | Named work samples with description, links, and optional lead media |
| Gallery | section-gallery | Showcase | Image, video, and audio tiles for your gallery layouts |
Projects appears under the Career divider (above Work Experience). Gallery appears under the Showcase divider. Use the ? next to Showcase for a short reminder and a Learn more link back here.
Appearance on the public page — grids, carousels, case-study layouts — comes from your theme. See Theme editor overview. This article covers content only. On Plus with extra pages, Appears on for the original Projects or Gallery list still assigns that section to one page. Extra copies you add under Additional sections can appear on more than one page — see Compose your portfolio and Reusable sections and pages. Adding and renaming pages: Nickname, URL, and pages.
Projects
Projects is for discrete pieces of work visitors (and job tools) can scan.
Click Add to open the Add Project side panel. Required field: Name. Add a Description (markdown) so the card has substance beyond the title. Optional fields include Project Type, Tags, Work Sample URL, Preview URL, Primary media, and PDFs.
Primary media accepts one image or video. Prefer picking from your library when the file already exists — see Media library (Phase 6; may 404 until published). Upload from the picker when you need a new file.
After save, each project shows as a list card. Use the card menu for Edit, Case study builder (when you want a structured story), or Delete (confirmation required).
Gallery
Gallery holds visual and playable media for gallery section layouts.
Click Add Media to open the Add Gallery Media side panel (bulk-friendly). Each item needs a Media title. Attach image, video, or audio; optional Category, Link URL, and a poster/thumbnail for playable media.
After save, items appear as tiles with edit and delete controls. Filter by search or category when the list grows; clear filters to see everything again.
Reorder projects and gallery
Both lists support order for public display:
- Drag — on larger screens, use the drag handle on a card or tile when the list has more than one item (“drag to reorder”).
- Rearrange — click Rearrange to open a dedicated reorder panel, set the order, and save.
Order is saved to the portfolio immediately after a successful drag or panel save. This is the order of items inside Projects or Gallery — not the order of sections on the page. Page section order lives in theme Layers. Preview or publish to confirm the themed page matches.
Links and media from the library
Project links (Work Sample URL, Preview URL) and gallery Link URL are plain URLs — they do not replace media uploads.
Lead project media and gallery files come through the media picker (upload or library). Storage and plan quotas are not listed here — see the FAQ and Plans and tokens (may 404 until published) for current limits.
Theme vs content
Changing a project description or gallery title does not change how the section is laid out. Layout, columns, and card chrome live in the theme editor. Keep this page focused on the content lists; open Theme editor overview when you need visual changes.
Tips
- Lead with a clear Name and a short Description before stacking optional PDFs or links.
- Attach Primary media when you have a strong still or clip — empty project cards look thin on themed grids.
- Use gallery Category values consistently so filters stay useful as the grid grows.
- Save open project or gallery panels before Publish / Publish draft — active edit sessions keep publish disabled.
- Use Preview after reordering to confirm the public sequence matches the editor.
Next to the Showcase divider in the editor, use ? for a short reminder and a Learn more link back to this article.
Troubleshooting
I cannot save a project or gallery item
- Look for fields marked Required and the save-row message asking you to fill required fields.
- Projects — confirm Name.
- Gallery — confirm Media title on each draft row before saving.
Rearrange or drag did not stick
- Wait for the success toast after drag or Rearrange save; a network error rolls the list back.
- Confirm you have more than one item — reorder controls appear when there are at least two.
Media upload failed or storage looks full
- Retry the picker; if the failure persists, check plan and media limits on the FAQ or Plans and tokens (may 404 until published).
- Prefer reusing files from the Media library when the asset already exists.
Showcase looks empty on the public page
- Confirm you saved the side panel and published (or previewed) after the change.
- Check that projects and gallery sections are visible in your theme; placement and styling come from the theme editor, not these forms.
Related articles
Portfolio editor overview
Jump nav, Setup Pages, workspace menu, save/publish, and Mira.
Services, testimonials, contact, embeds, blocks
Extra sections beyond intro, career, and showcase.
Compose your portfolio
Add extra galleries, projects, and other sections — then rename, copy, or delete them.
Reusable sections and pages
Share one section across Plus pages with Appears on, or keep independent copies.