Sanity CMS editing guide

Everything you need to update content on the site. No code required — just log in and edit.

In this guide

  1. Logging into Sanity Studio
  2. What you can edit
  3. Editing text content
  4. Swapping images
  5. Managing products
  6. Editing FAQs
  7. Publishing changes
  8. Troubleshooting

1. Logging into Sanity Studio

Sanity Studio is the admin panel where all content editing happens. It's built into the website itself.

1

Go to the Studio URL

Open https://your-site.com/studio in your browser. The Studio is always at /studio on your domain.

2

Sign in with your account

Use the Google or GitHub account that was invited during setup. If you haven't received an invite, ask Roland.

3

Navigate the sidebar

The left sidebar lists all content types: Home Page, Products, Our Story, FAQ Items, Contact, and Site Settings. Click any item to view and edit.

Bookmark it

Save the /studio URL as a browser bookmark. You'll use it every time you need to make content changes.

2. What you can edit

Sanity controls the text and images on your site. You cannot change layouts, colors, fonts, or page structure — those require a developer.

Home Page

Hero headline, subtitle, badge text, featured section heading, feature cards, CTA text

✓ Fully editable

Products

Name, price, description, images, featured flag, slug

✓ Fully editable

Our Story

Quote, timeline entries, team members, values section

✓ Fully editable

FAQ

Questions, answers, display order

✓ Fully editable

Contact

Headline, subtitle, phone, email, hours, form subjects

✓ Fully editable

Site Settings

Site name, navigation labels, footer text

✓ Fully editable

Not editable in Sanity

Page layouts, colors, fonts, spacing, navigation structure, and component design are controlled by code. Contact Alf for these changes ($150/hr).

3. Editing text content

The most common task. Here's how to change any text on the site.

1

Find the content type

In the sidebar, click the content type that contains the text you want to change. For example, click "Home Page" to edit the homepage headline.

2

Click into the field

Each field is labeled (e.g., "Hero Headline", "Hero Subtitle"). Click the text field and type your changes. The editor auto-saves drafts as you type.

3

Publish

When you're happy with the changes, click the green Publish button in the bottom bar. The live site updates within seconds.

Line breaks in headlines

To force a line break in a headline, type \n where you want the break. The site code converts this to a visual line break.

4. Swapping images

Replace product photos, hero images, or team headshots.

1

Navigate to the image field

Open the content type (e.g., a Product). Scroll to the image field — you'll see a thumbnail of the current image.

2

Upload or replace

Click the image area and choose Upload to select a file from your computer, or Browse to pick from previously uploaded images. You can also drag and drop.

3

Set the hotspot (optional)

After uploading, click Edit to set a hotspot — the focal point. This ensures the important part stays visible when cropped for different screen sizes.

4

Don't forget alt text

Fill in the "Alt text" field below the image. Describe what's in the image — this is used by screen readers and helps SEO.

Image sizes

Sanity automatically generates optimized versions. Upload the highest quality original — at least 1200px wide for hero images, 800px for product photos.

5. Managing products

Add new products, edit existing ones, or mark items as featured.

1

View all products

Click "Product" in the sidebar. You'll see a list of all products. Click any to edit.

2

Add a new product

Click + Create (top right). Fill in all fields: name, slug, price, description, image. Set "Featured" to true for homepage display.

3

Set the slug correctly

The slug creates the product's URL (e.g., "luxury-pup-sedan" → /products/luxury-pup-sedan). Use lowercase, hyphens, no special characters. Click "Generate" to auto-create from the name.

Don't change slugs after launch

Changing a product's slug breaks any existing links or bookmarks to that product page. If you must change it, contact Alf to set up a redirect.

6. Editing FAQs

Add, reorder, or update frequently asked questions.

1

Open FAQ Items

Click "FAQ Item" in the sidebar. Each FAQ is a separate document with a question, answer, and order number.

2

Edit or add

Click an existing FAQ to edit it, or click + Create to add a new one. Set the "Order" field to control display position (lower numbers appear first).

3

Delete an FAQ

Open the FAQ, click the menu (three dots) top right, and select Delete. Confirm the deletion. The FAQ disappears after the next page load.

7. Publishing changes

How drafts, publishing, and the live site connect.

1

Draft vs. Published

Every edit is saved as a draft first (auto-saved). The live site only shows published content. You'll see a yellow "Draft" indicator when you have unpublished changes.

2

Publish when ready

Click the green Publish button in the bottom-right corner. Changes go live within seconds — Sanity pushes the update automatically.

3

Revert if needed

Made a mistake? Before publishing, click Discard changes to go back to the last published version. After publishing, you can still edit and re-publish — but there's no automatic "undo."

Preview your changes

Before publishing, open the live site in another browser tab. After you publish in Sanity, refresh the site tab to verify the changes look right.

8. Troubleshooting

Common questions and solutions.

I published but the site hasn't updated
Changes typically appear within 5–10 seconds. Try hard-refreshing your browser (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows). If it still doesn't update after a minute, check the Vercel dashboard for deployment status.
My image looks cropped weirdly
Open the image in Sanity, click Edit, and adjust the hotspot (the circle overlay). Drag it to the focal point of your image — the part that should always be visible regardless of crop.
I accidentally deleted something
If you deleted a document, it's gone from Sanity. You'll need to recreate it. For important content, consider copying text to a Google Doc as backup before major changes. If you need to restore something complex, contact Alf.
Can I add a new page?
No — adding new pages requires code changes. Sanity controls content on existing pages, not page structure. Contact Alf to scope and quote a new page.
Can I change the font or colors?
No — fonts, colors, and layouts are controlled by the site's code, not Sanity. These changes require development work. Contact Alf ($150/hr).
Who do I contact for help?
For content questions (what to write, which images to use): ask Roland. For technical issues (site down, things look broken, need a new feature): Roland will coordinate with Alf.