# Organization Info

## Organization Info

**File:** `src/config/config.toml` (`[organization]`) · **Skill level:** Beginner

Your organization's name, registration number, phone, email, address, and office hours are written **once**, in the `[organization]` table of `config.toml`. Every page reads them from there: the header, the footers, the contact page, the donation form's fine print, the forms, the event pages, the structured data for search engines, and `llms.txt`. Change a number here and it changes everywhere.

All the shipped values are samples. The registration number is made up, the phone number uses the fictional 555-01xx range, and the address is invented. Replace them before you launch.

### The Organization Table
```toml
# src/config/config.toml
[organization]
  name = ""                          # Public name. Empty uses site.title
  legalName = ""                     # Registered legal name, if different
  registrationNumber = "12-3456789"  # sample. Empty hides it
  type = "NGO"                       # NGO | Organization | LocalBusiness
  nonprofitStatus = "Nonprofit501c3" # sample. Empty leaves it out
  foundingYear = "2009"              # sample
  taxNote = true                     # "Gifts are tax-deductible where the law allows"
  sameAs = []                        # extra profile URLs for structured data only
  phone = "+15550100199"             # sample. E.164 format. Empty hides every call link
  phoneDisplay = "(555) 010-0199"    # sample. How the number is shown
  sms = ""                           # optional number for "Text" links
  smsDisplay = ""
  email = "hello@example.org"        # sample. PLACEHOLDER: replace
  priceRange = ""                    # leave empty for a non-profit
  timezone = "America/New_York"      # IANA time zone
  closedDates = [
    "2026-12-25",
    "2027-01-01",
  ]                                  # sample. Office closed on these days (YYYY-MM-DD)
```

| Key                  | What to write                                                                                     |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| `name`               | Your public name. Leave it empty to use `[site] title`                                            |
| `legalName`          | Your registered legal name, if it differs ("Example Foundation Inc."). Used in the footer line and structured data |
| `registrationNumber` | Your charity or non-profit registration number: an EIN, a charity number, a SIREN, or similar. It shows in the footers and the donation fine print. Empty hides it everywhere |
| `type`               | `NGO` for a charity or non-profit (the default), `Organization`, or `LocalBusiness` for a walk-in office or shop (adds opening hours and a map pin to the structured data) |
| `nonprofitStatus`    | Optional. A schema.org non-profit type such as `Nonprofit501c3` (US), `NonprofitANBI` (NL), `CharitableIncorporatedOrganization`, `LimitedByGuaranteeCharity`, or `UKTrust` (UK). Empty leaves it out |
| `foundingYear`       | The year you were founded, as four digits. Empty leaves it out                                    |
| `taxNote`            | `true` shows the line "Gifts are tax-deductible where the law allows" with the donation fine print and in `llms.txt`. Set it to `false` if gifts to you are not tax-deductible. The wording is `organization.taxNote` in `src/i18n/<language>.json` |
| `sameAs`             | Profile URLs that are not social icons, such as your listing on a charity register or a Wikipedia page. Structured data only |
| `phone`              | The number as it is dialed, in **E.164** format: `+`, the country code, then digits only. `+15551234567`, `+447700900123`. This is what call links use |
| `phoneDisplay`       | The number as people read it: `(555) 123-4567`, `07700 900123`                                   |
| `sms`, `smsDisplay`  | A mobile number that takes text messages, in the same two formats. It adds a "Text" option on the contact page. Empty hides it |
| `email`              | Your public email address                                                                         |
| `priceRange`         | Leave it empty. It is used only with `type = "LocalBusiness"`                                    |
| `timezone`           | Your time zone, for example `"America/Chicago"`, `"Europe/London"`, `"Europe/Paris"`. It decides the "open now" line, and event times are read in it unless an event sets its own |
| `closedDates`        | Days the office is closed, as `"YYYY-MM-DD"`                                                      |

<Aside type="caution" title="Use the E.164 format for phone and sms">
  A number without the `+` and country code is not valid. The build then
  prints an `[organization]` warning and ignores the value, and the call links
  disappear. The build never fails on these values, so read the warnings.
</Aside>

### Address
```toml
  [organization.address]
    show       = true   # false = no street address (home-based or virtual office)
    street     = "100 Example Street, Suite 200" # sample
    locality   = "Springfield" # city, sample
    region     = "ST"          # state or province, sample
    postalCode = "00000"       # sample
    country    = "US"          # ISO 3166-1 alpha-2
```

`country` is the two-letter country code (`US`, `CA`, `GB`, `FR`). If you have no office that visitors can come to, set `show = false`: the street and postal code are then hidden on every page, and only the city and region show.

`[organization.geo]` takes an optional `latitude` and `longitude`. It is used only with `type = "LocalBusiness"`. Leave both empty if you are not sure.

### Office Hours
```toml
  # Office hours per day, 24-hour "HH:MM-HH:MM". Several ranges: "08:00-12:00,13:00-17:00". Empty = closed.
  [organization.hours]
    mon = "09:00-17:00" # sample
    tue = "09:00-17:00" # sample
    wed = "09:00-17:00" # sample
    thu = "09:00-17:00" # sample
    fri = "09:00-16:00" # sample
    sat = ""
    sun = ""
```

- Use the 24-hour clock: `"09:00-17:30"`, not `"9am-5:30pm"`.
- A lunch break is two ranges: `"09:00-12:00,13:00-17:00"`.
- `""` means closed that day.
- Hours that run past midnight are not supported.

The site groups days with the same hours for you and writes the times in the format of the page's language. The "open now" line in the `utility` header uses `timezone`, so a visitor in another time zone still sees whether your office is open.

### Where Each Value Appears
| Value                         | Where it shows                                                                                      |
| ----------------------------- | --------------------------------------------------------------------------------------------------- |
| `phone`, `phoneDisplay`       | The phone in the `centered` header, the call link in the `utility` header strip, the mobile menu, the `default` and `large` footers, the contact page, the call-to-action band, the help box beside the questions, the community hero, and page headers that show a phone line |
| `sms`, `smsDisplay`           | The "Text" option on the contact page                                                               |
| `email`                       | The `default` and `large` footers, the contact page, the help box beside the questions, and job pages                     |
| `address`                     | The `default` and `large` footers, the legal line of the footers, the contact page, the community hero, and job pages |
| `hours`, `timezone`           | The office hours in the `large` footer, on the contact page, and in the community hero; the "open now" line of the `utility` header |
| `timezone`                    | Event times and their add-to-calendar files, when an event has no `timezone` of its own              |
| `registrationNumber`          | The footers, the donation fine print on `/donate/`, the donate widget note, and `taxID` in structured data |
| `name`, `legalName`           | The footer line, structured data, `llms.txt`, the RSS feed title, and the default author meta tag   |
| `type`, `nonprofitStatus`, `foundingYear`, `sameAs`, `geo` | The structured data (JSON-LD) only                                     |
| Everything                    | The organization entry in the structured data on every page, and the top of `/llms.txt`             |

The organization name in the header is not `[organization] name`: it is `logoText` in `[site]`. The footer copyright uses `{brand}`, which is `site.title`. When you rename the organization, change all three. See [Site Identity & Logo](/givo/customization/site-identity-logo/).

Social profile links (the footer icons, and `sameAs` in structured data) are in `src/config/social.json`. See [Footer](/givo/customization/footer/#social-links).

### Use The Details In Your Own Text
In the body of a Markdown (`.md`) page, such as the legal pages or a story written as `.md`, you can type these tokens and the site fills in the value:

| Token            | Becomes                                          |
| ---------------- | ------------------------------------------------ |
| `{name}`         | `[organization] name`                            |
| `{registration}` | `registrationNumber`                             |
| `{phone}`        | `phoneDisplay`                                   |
| `{email}`        | `email`                                          |
| `{address}`      | The address, formatted for the page's language   |
| `{hours}`        | The office hours, grouped by day                 |

A few fields in content files accept tokens too: the announcement bar text, the form messages, and the donation fine print (`Registered charity no. {registration}` in `donate-section.md`). The comment next to a field says when it does. `.mdx` files read `{…}` as code, so the tokens don't work there.

### Check It
1. Run `npm run dev` and read the terminal: an `[organization]` line names any value that was ignored.
2. Open `/contact/` and check the phone, email, address, and hours.
3. Open `/donate/` and read the fine print under the form: your registration number should be there.
4. Open `/home-community/` to see the "open now" line in the `utility` header.
5. In a browser, view the page source and search for `"taxID"` and `"telephone"` to see what search engines get.

### Do It With AI
```text
Set my organization details in [organization] of src/config/config.toml: name "[NAME]",
legal name "[LEGAL NAME]", registration number [NUMBER], phone [NUMBER] (convert it to E.164
for phone and keep my format for phoneDisplay), email [EMAIL], address [STREET, CITY, REGION,
POSTAL CODE, COUNTRY], time zone [ZONE], office hours [DAYS AND TIMES], closed on [DATES].
[Gifts to us are not tax-deductible: set taxNote = false.] [Set nonprofitStatus to "" .]
Remove the "# sample" comments on the values you change.
```