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

What Is Editable In Tina

Files: src/content/, src/config/, src/i18n/, tina/ · Skill level: Beginner

Keep npm run dev running, open http://localhost:4321/admin/, and click Enter Edit Mode. You need no account and no password. Open the menu at the top left, then pick an entry, a language folder, and a file. Tina has the full guide. Everything below exists in English, French, and Arabic, and an edit changes one language.

Give a page about five seconds after it opens, because a page with many sections loads a form for each one. Saving a large form, such as a homepage, can take up to half a minute, so wait for it to finish before you leave the page.

Where Each Page Is Edited

The last column lists the blocks in the page’s own form. Fill one in to change that section on this page only. Every other section comes from Section defaults.

AddressEntry in /admin/The page’s own blocks
/Home pages, file -indexHero, Steps, Why Us, Metrics, Services, Reviews, Contact, Questions, Related Posts, Cta
/home-cleaning/Home pages, file home-cleaningHero, Why Us, Services, Plans, Steps, Feature Grid, Reviews, Booking, Questions, Related Posts, Areas, Cta
/home-commercial/Home pages, file home-commercialPrimary Cta, Hero, Services, Why Us, Feature Grid, Reviews, Team Grid, Related Posts, Contact, Cta
/home-handyman/Home pages, file home-handymanHero, Trust Strip, Why Us, Services, Metrics, Feature Grid, Steps, Reviews, Before After, Questions, Related Posts, Cta
/about/About pageAbout Hero, Story, Values, Steps, Team Grid, Careers Band, Cta
/services/Services, the listing pagePage Header, Services, Industries Strip, Included, Add Ons, Questions, Cta. Detail and Templates hold blocks for every service page
/services/{slug}/Services, one file per serviceIncluded, Estimate, Cta, and Repair
/pricing/PricingPage Header, Plans, Estimate, Add Ons, Rates, Included, Questions, Cta. Frequencies, Rate Cards, and Add Ons hold the prices
/areas/Service areas, the listing pagePage Header, Areas, Reviews, Questions, Cta
/areas/{slug}/Service areas, one file per areaCta. Hours and Office are fields of the area
/industries/Industries, the listing pagePage Header, Contact, Cta. Detail holds blocks for every industry page
/industries/{slug}/Industries, one file per industryIncluded, Services, Steps, Before After, Questions, Contact, Cta
/projects/Projects, the listing pagePage Header, Before After, Reviews, Related Projects, Cta
/projects/{slug}/Projects, one file per projectCta
/team/Team, the listing page. Team also has one file per memberPage Header, Team Grid, Careers Band, Cta
/careers/Careers, the listing pagePage Header, Open Roles, Values, Steps, Questions, Application, Cta
/careers/{slug}/Careers, one file per jobCta
/blog/Blog, the listing pagePage Header, Blog List, Newsletter, Cta
/blog/{slug}/Blog, one file per postNewsletter, Related Posts, Cta
/blog/category/..., /blog/tag/..., /blog/page/...Built from the postsNone
/guarantee/Guarantee pagePage Header, Trust Strip, Compliance, Steps, Questions, Guarantee Claim, Cta
/faq/FAQPage Header, Questions, Cta
/contact/Contact pagePage Header, Contact, Contact Options, Questions, Cta
/book/Other pages, file bookBooking, Trust Strip, Questions
/book/thanks/Other pages, file book-thanksNot Found
/how-it-works/Other pages, file how-it-worksSteps, Trust Strip, Included, Values, Questions, Cta
/reviews/Other pages, file reviews. The quotes are in ReviewsReviews, Cta
/gift-cards/, /referral/Other pagesGift Cards or Referral, Steps, Contact, Questions, Cta
/elements/Other pages, file elementsLayout Gallery, Estimate, Booking
Legal pagesOther pages, one file per pageContent Page
/components/Components page. Its body is edited as source codeCta
404Interface labels (Not Found) and the Not found section in Section defaultsNone

The form of Other pages lists every block those pages can use. A block only works on a page that shows that section.

Most page forms also have Main button on this page, Header layout, Footer layout, Robots, Leave out of llms.txt and Markdown copies, and Draft (not published).

New Entries

Use Create New in Services, Service areas, Industries, Projects, Careers, Blog, Team, Reviews, and Authors. The header menu doesn’t pick up a new service or area, so add its link in Menus and footer columns. 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

Section defaults holds the shared content of each section, 36 in all, in each language. A change there shows on every page that uses the section, unless the page has filled in its own block.

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/areas/, area pages, /home-cleaning/
Before after section/home-handyman/, /projects/, service, area, industry, and project pages
Blog list section/blog/, its pages, and category and tag pages
Booking section/book/, /home-cleaning/
Call to actionAbove the footer, on pages that turn it on
Careers band section/about/, /team/
ClientsCommercial service pages, and the logo row of the reviews spotlight layout
Compliance section, Guarantee claim section/guarantee/
Contact options section/contact/
Contact section/contact/, /, /home-commercial/, /industries/, industry pages, /gift-cards/, /referral/
Cookie consentThe cookie banner on every page
Estimate section/pricing/, service pages
Feature grid section/home-cleaning/, /home-commercial/, /home-handyman/
Hero section, Why us section, Related posts sectionAll four homepages. Related posts also shows under each blog post
Included section/pricing/, /services/, /how-it-works/, service and industry pages
Metrics section/, /home-handyman/
Newsletter sectionBlog list pages and posts
Not covered sectionRepair service pages
Not found section404 pages, /book/thanks/
Open roles section/careers/
Plans section/pricing/, /home-cleaning/
Questions sectionMost pages, including /faq/, /contact/, /book/, and /pricing/
Reviews sectionAll four homepages, /reviews/, /areas/, /projects/, service and area pages
Service hero sectionService pages
Services sectionAll four homepages, /services/, service, area, and industry pages
Steps section/, /home-cleaning/, /home-handyman/, /about/, /how-it-works/, /guarantee/, /careers/, /gift-cards/, /referral/, service and industry pages
Team grid section/team/, /about/, /home-commercial/
Trust strip/home-handyman/, /book/, /how-it-works/, /guarantee/. Its rating also feeds the hero and reviews
Values section/about/, /how-it-works/, /careers/

To hide a section, use its Enable field. To change its look, use Options > Layout. /elements/ previews every layout.

Site-Wide Content

EntryWhat’s in it
Site settingsSite (title, tagline, Base Url, logo), Business (name, phone, email, address, hours), Seo (robots.txt, AI files, sitemap), Settings, Opengraph, and Head for analytics tags
Menus and footer columnsHeader Primary (dropdowns, flyouts, and the mega menu) and Footer, in menu.en, menu.fr, and menu.ar. See Menus
Social linksYour social profiles
Interface labelsButtons, form messages, and footer copy (Footer), per language

Homio has four header layouts and four footer layouts. Choose them in Site settings > Settings > Layout, or per page with Header layout and Footer layout. Settings also holds Sticky Header, Navigation Button, Navigation Secondary Link, Mobile Action Bar, Copyright, Subscription, Theme Credit, Page Actions, Smooth Scroll, Color Scheme, Cookie Consent, Estimator, Booking, Contact Form Action, and Contact Form Provider.

If You Clear A Field

In a page’s form, a field you never filled uses the default. A field you clear is saved empty, which hides that text or image on that page.

Tina can’t bring the default back by itself. To get the text back, do either of these:

  • Copy it from Section defaults into the field.
  • Remove the empty line from the page’s file in src/content/ with a text editor.

What The Preview Doesn’t Update

The header, the menus, and values from Site settings, such as contact details, don’t change while you type. They update when you save. Some Site settings also need npm run dev restarted, and the note on the field says so.

These have no click-to-edit outline, so change them in their forms: the header and menus, values from Site settings, images with no alt field, categories and tags, and one-word options. Online with Tina Cloud there are forms only.

When Tina saves, it removes comments and rewrites Markdown in its own style. Your words and values stay. If you also edit content files by hand, run npm run tina:audit.

What Stays In Code

  • Which sections a page has, and their order: the route in src/pages/[...lang]/. You can hide a section with its Enable field.
  • New sections, new page routes, and new layouts. Then run npm run tina:generate so the editor offers them.
  • Colors and type scale (src/styles/theme.css), fonts (src/config/fonts.json), and the logo mark (src/lib/brandMark.ts).
  • The list of languages. See Internationalization.
  • The price formula, booking steps, and area matching in src/lib/. The rates and settings they read are in Pricing and Site settings.
  • The icons themselves. Icon names are text you can edit.

Versions And Testing

This edition is tested on Astro 7.4.2 and Node 22, with tinacms 3.15.1, @tinacms/cli 4.0.4, and @tinacms/astro 0.8.0. They are pinned in package.json. The live preview uses experimental features of @tinacms/astro, so test it before you upgrade.

We have not run online editing against a live Tina Cloud project. Try one save on a copy of your site before you rely on it.

Do It With AI

I use the Tina edition. Tell me where to edit [TEXT OR SETTING] in /admin/: the entry, the language
folder, the file, and the field. If it comes from Section defaults, say which pages will change,
and how to change it on one page only. Don't change any files.
Type something to search...