Skip to content
New: Customize your theme with an AI assistant. Read the guide

What Is Editable In Sanity

Files: sanity.config.ts, sanity/, src/config/config.toml · Skill level: Beginner

Run npm run dev:all, open the Studio at http://localhost:3333, and log in with your Sanity account. Content has one entry per language, then Site settings. Sanity has the full guide, including npm run setup for your first project. Everything below exists in English, French, and Arabic, and each language has its own documents.

Where Each Page Is Edited

All locations are under Content, then your language. The last column lists the rows you can add under Sections on this page. Each row changes one section for this page only, and a field you leave empty keeps the section’s own content.

AddressStudio locationSections on this page rows
/Homepages > Home: MainHero, Clients, Services, Metrics, Steps, Reviews, Plans, CTA
/home-residential/Homepages > Home: ResidentialHero, Metrics, Services, Why Us, Steps, CTA, Before After, Reviews, Areas, Feature Grid, Contact, Questions
/home-water/Homepages > Home: WaterHero, Feature Grid, Metrics, Services, Why Us, Included, Reviews, Team Grid, Questions, CTA
/home-commercial/Homepages > Home: CommercialPrimary CTA, Hero, Industries Strip, Services, Compliance, Feature Grid, Steps, Reviews, Team Grid, Contact, Questions, CTA
/about/Main pages > About pageAbout Hero, Story, Values, Steps, Team Grid, Careers Band, CTA
/services/Main pages > Services pagePage Header, Services, Industries Strip, Included, Add Ons, Questions, CTA, and Detail and Templates for every service page
/services/{slug}/Services, one document per serviceEstimate, CTA, and Repair
/pricing/Main pages > Pricing pagePage Header, Plans, Estimate, Add Ons, Rates, Included, Questions, CTA. The prices are in its Frequencies, Rate Cards, and Add Ons fields
/areas/Main pages > Areas pagePage Header, Areas, Reviews, Questions, CTA
/areas/{slug}/Areas, one document per areaHours and Office only
/industries/Main pages > Industries pagePage Header, Contact, CTA, and Detail for every industry page
/industries/{slug}/Industries, one document per industrySteps, and Price
/projects/Main pages > Projects pagePage Header, Before After, Reviews, Related Projects, CTA
/projects/{slug}/Projects, one document per projectPrice and Quote only
/team/Main pages > Team page, and Team membersPage Header, Team Grid, Careers Band, CTA
/careers/Main pages > Careers pagePage Header, Open Roles, Values, Steps, Questions, Application, CTA
/careers/{slug}/Jobs, one document per jobPay only
/blog/Main pages > Blog pagePage Header, Newsletter, CTA
/blog/{slug}/Blog posts, one document per postNone
/blog/category/..., /blog/tag/..., /blog/page/...Made from Blog postsNone
/guarantee/Main pages > Guarantee pagePage Header, Trust Strip, Compliance, Steps, Questions, Guarantee Claim, CTA
/faq/Main pages > FAQ pagePage Header, Questions, CTA
/contact/Main pages > Contact pagePage Header, Contact, Contact Options, Questions, CTA
/book/, /book/thanks/, /emergency/, /specials/, /referral/, /how-it-works/, /reviews/, /elements/, /components/, legal pagesOther pages, one document per page. The quotes on /reviews/ are in ReviewsThe same list for every page: use the sections that page shows
404Sections > Not found section, and Interface labelsNone

On Areas, Projects, Jobs, Industries, and Reviews, this list also holds parts of the entry that aren’t sections, such as Hours or Reply.

A service page shows the sections of its template, set in its Options > Layout. Not covered shows on repair pages, Clients and Contact on commercial pages, and Before after on default and estimate pages. On estimate pages, such as /services/drain-cleaning/, the estimator is in the hero.

Plumbo’s Studio has no Page options group. Each document’s page fields sit with its other fields: Meta Title and Meta Description on most pages, and Draft on most documents (not the homepages). Robots and Exclude From Sitemap are on Other pages and the residential, water, and commercial homepages. Exclude From AI is only on Other pages. Header Layout is on the four homepages, and Footer Layout is on the four homepages and Other pages.

New Entries

Use the + button in Services, Areas, Industries, Projects, Reviews, Blog posts, Authors, Team members, Jobs, and Other pages. The header menu doesn’t pick up a new service or area, so add its link in Menus. See Menus.

A new entry with only a title won’t break the site, and it builds. Its card or page shows what you filled in, and images and other fields stay empty until you add them, so fill them in before you publish.

Sections

Each section is one document per language, under Sections. Open its Section content row to edit it. Every page that shows it uses this content, unless the page changes it under Sections on this page.

SectionWhere it appears
About hero section, Story section/about/
Add ons section/pricing/, /services/, service pages
Announcement barAbove the header on every page. It ships off
Areas section/home-residential/, /areas/, area pages
Before after section/home-residential/, /projects/, project, area, and industry pages, and service pages
Blog list section/blog/, its pages, and category and tag pages
Booking section/book/, /elements/
Call to actionAbove the footer on most pages
Careers band section/about/, /team/
Clients/, commercial service pages
Compliance section/guarantee/, /home-commercial/
Contact options section/contact/
Contact section/home-residential/, /contact/, /home-commercial/, /industries/, industry pages, /referral/, commercial service pages
Cookie consentThe cookie banner on every page
Estimate section/pricing/, service pages, /elements/
Feature grid section/home-residential/, /home-water/, /home-commercial/, /specials/
Guarantee claim section/guarantee/
Hero sectionAll four homepages
Included section/home-water/, /pricing/, /services/, /how-it-works/, service and industry pages
Metrics section/, /home-residential/, /home-water/, /emergency/
Newsletter sectionBlog list pages and posts
Not covered sectionRepair service pages
Not found section404 pages, /book/thanks/
Open roles section/careers/
Plans section/, /pricing/, /specials/
Questions sectionMost pages, including /faq/, /contact/, /book/, and /pricing/
Related posts sectionUnder each blog post
Reviews sectionAll four homepages, /reviews/, /areas/, /projects/, service and area pages
Service hero sectionService pages
Services sectionAll four homepages, /services/, /emergency/, service, area, and industry pages
Steps section/, /home-residential/, /home-commercial/, /about/, /how-it-works/, /guarantee/, /careers/, /emergency/, /specials/, /referral/, service and industry pages
Team grid section/team/, /about/, /home-water/, /home-commercial/
Trust strip/book/, /how-it-works/, /guarantee/. Its rating also feeds the hero and reviews
Values section/about/, /how-it-works/, /careers/
Why us section/home-residential/, /home-water/

To hide a section, use its Enable field. To change its look, use Options > Layout. /elements/ previews every layout, and its notes still name the file paths of the Astro edition.

Site-Wide Content

LocationWhat’s in it
MenusHeader menu, with Dropdown items and Mega menu columns, and Footer columns. Each language has its own. See Menus
Interface labelsButtons, labels, form messages, and footer copy, as a list with a search box. There are more than 500. Each language has its own
Site settingsOne for the whole site, below the languages: Site, Business, SEO, Settings, Opengraph, Head for analytics tags, and Social

Settings holds the header and footer layouts (Layout), Navigation Button, Mobile Action Bar, Copyright, Subscription, Theme Credit, Page Actions, Smooth Scroll, Color Scheme, Cookie Consent, Estimator, Booking, Contact Form Action, and Contact Form Provider.

Site settings apply when the site builds. While npm run dev:all runs, they apply when you publish them, and the page reloads. They don’t change as you type, and click-to-edit doesn’t reach them, so change them in their form. Click-to-edit also doesn’t reach option values, links, icon names, hours, interface labels, or images set as a CSS background.

Text in body fields can use {phone}, {email}, {address}, {hours}, and {name}. They show the values from Site settings > Business.

Numbers In Arabic Text

Body text has a Left to right mark, with Strong and Emphasis in the editor’s toolbar. Select a number with its unit inside Arabic text, such as -3 °C, and apply the mark, so it keeps its order. It does the same as <bdi dir="ltr"> in the Astro edition. Prices, phone numbers, and addresses stay left to right by themselves, so they don’t need it.

Plans And Attributes

At the time of writing, Sanity’s free plan allows 2,000 attributes, one for each distinct field path in your content. Plumbo’s demo content, with its images, measured 1,632 in our test project, read from Sanity’s own count after importing it and using Live preview. It fits, with 368 left.

To stay there, labels are one searchable list, a section’s fields sit in one row, and images have no crop or hotspot option, which would add 12 attributes for each image field. Adding entries, pages, and text costs nothing. New field names use more, and so do deeper menu levels or blocks nested more deeply in a body field. You can see your own number in Sanity’s project settings, under Usage. Sanity’s pricing page has the current limits.

Online Preview

Click-to-edit and draft preview work out of the box on your own computer, with npm run dev:all. To use them online, your editors need a second copy of the site running as a small Node.js server, because drafts can’t be shown from static files. A static host can’t do this. See Sanity for the steps. Without a preview server, editors online can still edit in the Studio’s forms and publish.

What We Tested

On this theme: the demo content imported into a real Sanity project, editing in Live preview in English and Arabic, and the preview server running on localhost.

Not tested on this theme:

  • Any online host, a deployed Studio, or a webhook from end to end.
  • Netlify or Vercel functions, which the preview server doesn’t support.
  • npm run setup all the way through, importing from the unzipped zip, and adding a language.

Try these on your own project before you rely on them.

What Stays In Code

These change how the site is built, not what it says:

  • The page routes and the order of sections on a page: src/pages/[...lang]/.
  • Section and component design, colors, type scale, and fonts.
  • The list of languages: src/config/language.json.
  • Favicons, the language settings, and the collection folder names in config.toml.
  • The layout switcher settings, and the list of sections shown on /elements/.
  • The AI crawler lists. The on and off switches are in Site settings.
  • Which sections and fields exist. To add one, see SKILLS.md.

Do It With AI

I use the Sanity edition. Tell me where to edit [TEXT OR SETTING] in the Studio: the language entry,
the document, and the field. If it comes from a section document, say which pages will change,
and how to change it on one page only. Don't change any files, and don't print anything from .env.
Type something to search...