# Admin guide: editing the iDealers website

This guide is for the site owner. No technical knowledge needed. Each task is a few short steps. The screen names below are the ones in the admin panel (checked against the finished panel on 2026-11-17).

## The basics

- The admin panel is at **https://idealers.net/admin** (your developer may have given you a different address).
- The left menu has three groups: **Website** (Pages, Site settings, Media library), **SEO** (Redirects) and **Administration** (Users, Activity log).
- You can change **text, images, videos, links, menus, pricing plans, testimonials, search-engine (SEO) details and site settings**. The designed layouts of the 15 pages stay as they are; you can add your own sections between their parts and build new pages from ready-made sections (chapter 12).
- Every page starts with the **original content** of the old website. Anything you change is saved on top of it. A field you have changed shows an orange **Edited** mark, the original text underneath, and a **Reset to original** link, so you can always undo.
- Changes to page content appear on the live site **as soon as you press Save changes**. Only the page builder (chapter 12) has drafts and a separate **Publish** step.
- If you leave a page with unsaved changes, the admin warns you first.
- Every change is recorded with your name and the time (see "Activity log" below).

## 1. Sign in

1. Go to https://idealers.net/admin.
2. Enter your e-mail address and password and press **Sign in**.
3. If two-factor login is on for your account, a page **Verify your identity** opens. Open your authenticator app (Google Authenticator, Microsoft Authenticator, 1Password...), type the 6-digit code it shows for **iDealers admin** into the six boxes and press **Confirm sign in**. No phone at hand? Click **Use a recovery code instead** and type one of your recovery codes.

Good to know:
- After 30 minutes without activity you are signed out automatically. Unsaved changes are lost, so save as you go.
- After 5 wrong passwords, sign-in for that e-mail address is blocked for 15 minutes. Wait, then try again.
- The sign-in form also refuses quick repeated attempts with "Too many login attempts. Please try again in N seconds". Wait the number of seconds shown.
- A 6-digit code works only once and only for about 30 seconds. If it is refused, wait for the app to show the next code.
- There is no "Forgot password" link (on purpose, for security). If you forget your password, ask your developer: they reset it with one command (`php artisan site:create-admin --email=you@... --update`). Another admin cannot see your password.
- To sign out: click your initials at the top right, then **Sign out**.

## 2. Edit a page's text, images and links

1. Left menu: **Website > Pages**. You see the 15 pages of the site plus **Global** (the parts shared by every page: top bar, menus, the "#1 DMS Software" block above the footer, footer, cookie notice, error pages).
2. Click the page you want, for example **About us**.
3. The **Content** tab shows the page in sections from top to bottom (for example "Hero", "Mission", "Success"). Click a section title to open or close it.
4. Change the text in the box.
   - Short texts (headings, button labels) are single lines.
   - Longer texts have a small toolbar: **bold**, *italic*, underline, strike-through, link, headings, paragraph, bullet and numbered lists, quote, table, clear formatting, undo/redo. Keep formatting simple; the design takes care of fonts and colours.
5. Press **Save changes** at the bottom (or Ctrl+S). A green message confirms "Saved. The live page is updated."
6. Press **View page** (top right) to open the live page in a new tab and check the result.

To undo a change: click **Reset to original** next to the field (it appears only on edited fields) and confirm with **Reset**. The field goes back to the text of the old website at once.

### Change an image or video

1. Open the page and the section as above.
2. At the right end of the image field (the box with the file address, for example `/media/2022/12/about26.png`) there are two small icon buttons; hold the mouse over them to see their names. A preview of the current picture is shown under the box.
   - **Upload** (arrow pointing up): choose a file from your computer, add a short description, press **Upload and use**. The message says "Uploaded. Click "Save changes" to publish it."
   - **Library** (picture icon): pick a picture that is already on the website (every image of the old site is in the library).
3. Most images have an **alt text** field next to them (its label ends in "alt text"). Fill in one short sentence that says what the picture shows, for example "Laptop showing the iDealers inventory list". Search engines and blind visitors rely on it. Leave it **empty** only for pure decoration (swooshes, frames, a logo whose name is printed beside it). When you replace a picture, check that its alt text still describes the new one. The current texts are listed in `docs/review/alt-texts.md`.
4. Press **Save changes**.

Allowed files: JPG, PNG, WebP, GIF and AVIF images up to 5 MB, MP4 and WebM videos up to 50 MB. SVG files are refused for security reasons. For speed, upload images no wider than about 2000 pixels.

Lighter versions are made for you: when you upload a picture, the site immediately creates smaller AVIF and WebP copies of it at several widths and serves each visitor the smallest one that looks sharp on their screen. You do not need to do anything; the original file stays as you uploaded it. (After a deploy the developer runs `php artisan site:images`, which recreates these copies if needed.)

### Change a button or link

Buttons have two fields: the **label** (the words on the button) and the **link**. For pages on this website use the short form, for example `/pricing/`. For other websites use the full address starting with `https://`. Phone links look like `tel:844-444-9363`, e-mail links `mailto:info@idealers.net`. Anything else is refused when you save.

### Fields that came with the dark design (November 2026)

The dark redesign moved some pictures into the content and dropped a few decorations, so some pages have new or fewer fields:

- **Home**
  - **Word of the title shown as the big light window** (`hero.mask_word`): which word of the title "A Modern Dealership Software" is drawn as the big coloured lettering. It must be one word of the title exactly; the title itself is still edited in **Title (h1)**.
  - **Word(s) of the title shown in mint** (intro title, "priority") and **Part of the second title shown in mint** (Talk to Sales, "Less effort."): must be copied exactly from the title, otherwise nothing is coloured.
  - New pictures, each with an alt text field: **Laptop picture (services scene)**, **Dashboard picture** (tilts flat, the play button for the promo video sits on it), **Picture beside the 1st statement** (Design Studio), **Picture beside the 2nd statement** (devices). **Credit Leads screen alt text** and **Test drive screen alt text** are new too.
  - **Product orbit beside the 3rd statement (screen readers)**: the description read to blind visitors for the circling product icons (the icons themselves come from the **Products** list).
  - **...button: what it opens (screen readers only)** fields complete short links such as "Read more" for screen readers ("Read more about Credit Leads").
  - Removed (they no longer show anything): the hero, leads and Talk to Sales background pictures, the old laptop video picture, the leads device frame, the floating decoration, the custom mouse cursor and the Lottie animation.
- **Global > Footer**: **Footer tagline under the logo**, shown under the logo in the footer ("A Modern Dealership Software").
- **Product pages** (Inventory, Leads Center, Website, Marketing Tools, CRM): the device frame pictures and the custom mouse cursor are gone (the devices are now drawn by the design); the **...screenshot alt text** fields (formerly "device frame alt text") describe the screenshot shown in the device.

## 3. Edit the menus, footer, phone number and cookie notice

These appear on every page, so they live under **Website > Pages > Global**. Its sections are:

- **Topbar**: social icons, "CALL US" phone text and phone link.
- **Header**: logo, the **Products menu** and **Company menu** (lists), Pricing, Dealership Login and Request A Demo labels and links.
- **Mobile bar**: the label of the "Call" button in the bar at the bottom of phone screens (it dials the Topbar phone link; the "Request A Demo" button uses the header's demo label and link).
- **Prefooter**: the "#1 DMS Software" block (image, title, subtitle, text, button, Take a Tour video).
- **Footer**: the four column titles and their link lists, social links, copyright line, credit line.
- **Cookie**: the cookie notice. Six fields: the **notice text**, the **Privacy Policy link label** and **link**, the **Decline** and **Accept** button labels, and the footer link that reopens the notice (**Cookie settings**). Keep the text honest about what happens: analytics start only after Accept.
- **Errors**: the wording of the "page not found" and other error pages.

Menus and footer columns are **lists**: each row is one link (label + link).
- Change a row: edit its fields.
- Add a row: press **Add** at the bottom of the list.
- Remove a row: use the bin icon on the row.
- Reorder: drag the row by its handle.

Then press **Save changes**. Editing one row never changes the other rows.

## 4. Edit pricing plans

Plans are on two pages: **Pricing** (Starter, Premium, Ultimate) and **Design Studio Tool** (Designer, Marketer, Hands-Up).

1. **Website > Pages**, open **Pricing** (or **Design Studio Tool**).
2. Open the **Plans** section (on Design Studio Tool: **Pricing**). Each plan is one row with: ribbon (for example "Popular", empty for none), plan name, subtitle, previous price (crossed out), currency symbol, price, period ("/ Per Month"), button label, **Button link (Stripe payment link)** and **Features** (one feature per line).
3. In Features you may make a line bold with `<strong>...</strong>` or coloured with `<span style="color: #d95754;">...</span>`, as the original "All in Starter Plan" line does.
4. Press **Save changes**.

**Be careful with the Stripe payment links.** Each link belongs to one product in your Stripe account. If you change a price on the website, also change the price (or create a new payment link) in Stripe and paste the new link here. Test the button afterwards: it must open the right Stripe checkout.

The prices you type here are also what Google is told (structured data on the Pricing page), so a price change needs no other step.

### Comparison table, FAQ and "Not sure which plan fits?" strip

Below the plan cards, both pricing pages have a comparison table, a FAQ list and a Talk to Sales strip (the Design Studio FAQ list is empty, so no FAQ shows there until you add a question). Their fields are on the same page in the admin; the field labels start with **Comparison:**, **FAQ:** and **Talk to Sales strip:**.

- **Comparison: table rows** is a list. Each row has **Feature** and one box per plan, in the same order as the plan cards (1st plan, 2nd plan, 3rd plan). Type `yes` for a tick, `no` for a dash, or any other words to show those words (for example `Advanced`). Screen readers say "Included" / "Not included" for the tick and dash; those two words, the table caption and the "Feature" column heading are fields too. If you add or rename a plan, update the table rows yourself; the column titles follow the plan names.
- **FAQ: questions and answers** is a list of question + answer (plain text). Press **Add item** under the list for a new question, fill both boxes, **Save changes**. The FAQ block, and the FAQ information given to Google, only appear when the list has at least one question. Remove a question with the bin icon on its row. Only publish answers you are sure of (for example contract length or setup fee).
- **Talk to Sales strip**: heading, text, button label and button link (`/talk-to-sales/`).

## 5. Edit testimonials

Testimonials (client quotes) are on the **Design Studio Tool** page.

1. **Website > Pages > Design Studio Tool**, open the **Testimonials** section.
2. Each row is one quote: **Quote**, **Logo / photo**, **Name** and **Title** (for example "Dealership").
3. Add, edit, remove or drag to reorder, then press **Save changes**.

## 6. Change SEO details (title, description, sharing image)

1. **Website > Pages**, open the page.
2. Click the **SEO** tab. The section **Search engines and social media** has:
   - **Page title**: the blue headline in Google results and the browser tab. Keep it under about 60 characters (a length hint is shown).
   - **Meta description**: the grey text under it in Google. About 120-155 characters, written for people.
   - **Social sharing image**: the picture shown when the page is shared on Facebook, LinkedIn, WhatsApp...
   - **Search engine indexing**: leave it on the default ("index, follow") unless you really want to hide a page from Google.
   - **Canonical address (advanced)**: leave empty.
3. An empty field means "use the original value". Press **Save changes**.

The original titles and descriptions of every page are listed in `docs/SEO_BASELINE.md` (ask your developer) if you ever want to go back.

## 7. Add a redirect

Use a redirect when an address changes or disappears, so visitors and Google land on the right page instead of an error.

1. Left menu: **SEO > Redirects**, then **New redirect**.
2. **Old address (path)**: the path that should no longer be used, for example `/old-offer/`.
3. **Type**: **301 Moved permanently (normal choice)** for anything lasting; 302 or 307 only for short campaigns; **410 Gone** for a page that was removed on purpose (no new address needed).
4. **New address**: where to send people, for example `/pricing/` or a full `https://` address.
5. Leave **Active** on and press **Create**.

The list shows how often each redirect was used and when it was last used. Switch **Active** off to pause one without deleting it.

## 8. Set the Google Analytics ID and other site settings

1. Left menu: **Website > Site settings**.
2. Section **Analytics**:
   - **Google Analytics 4 measurement ID**: looks like `G-XXXXXXXXXX`. Find it in Google Analytics > Admin > Data streams > your web stream.
   - **Google Tag Manager container ID** (optional): `GTM-XXXXXXX`.
   - **Google Search Console verification code** and **Bing Webmaster verification code**: only the code inside `content="..."` of the tag they give you.
   - **Meta (Facebook) Pixel ID** and **Hotjar site ID** (optional): numbers only. The old site used Hotjar 3840705 and Meta Pixel 263970003369260.
   Leave a box empty to switch that tag off.
3. Section **SEO**: site name, title suffix, default social sharing image, X (Twitter) handle, default search engine instructions (keep "index, follow..."), and **Hide the whole site from search engines** (never switch this on for the live site; it is only for test copies).
4. Section **External services**: the **Dealership login address** and the addresses of the three **embedded forms** (Contact, Request a demo, Talk to sales). Only change these if idealers.app gives you new ones.
5. Press **Save settings**.

Visitors' privacy: nothing from Google, Meta or Hotjar loads until a visitor clicks **Accept** on the cookie notice. **Decline** is remembered and the notice does not come back; the footer link **Cookie settings** reopens it, and declining there after an earlier Accept switches analytics off again and deletes the analytics cookies. To check it works: open the site in a private window, click Accept, then look at Google Analytics > Reports > Realtime; you should see yourself within a minute.

## 9. Add another admin

1. Left menu: **Administration > Users**, then **New user**.
2. Enter **Name** and **E-mail**, a temporary **Password** (at least 12 characters with upper- and lower-case letters, a number and a symbol) and **Repeat password**.
3. Switch on **Can sign in to the admin panel**.
4. Press **Create** and send them the address of the admin panel. Give them the password in a different way than the e-mail (for example by phone) and ask them to change it on their **Profile** page.

To remove someone's access, open the user and switch off **Can sign in to the admin panel** (or delete the user). The user list shows who has two-factor login on (**2FA** column) and when they last signed in. If someone loses their phone, use **Reset 2FA** on their row so they can set up their authenticator again.

## 10. Turn on two-factor login

Two-factor login means a password **and** a code from your phone. Your developer can make it compulsory for every admin (recommended); then you are asked to set it up the first time you sign in. To set it up yourself, or move it to a new phone:

1. Install an authenticator app on your phone (Google Authenticator, Microsoft Authenticator, 1Password, Authy...).
2. In the admin, click your initials at the top right, then **Profile**.
3. Under **Authenticator app**, press **Set up**. A window opens with a QR code and a text key.
4. In the app, tap **+ / Add account / Scan QR code** and scan it (or type the text key).
5. Type the 6-digit code from the app into the six boxes and your **current password** below, then press **Next**.
6. The window now shows your **recovery codes**. Save them in your password manager or print them ("Click to copy or download all the codes at once"). Each one lets you in once if you lose your phone.
7. Press **Enable authenticator app**. From now on, signing in asks for a code from the app.

## 11. Media library and Activity log

- **Website > Media library**: all pictures and videos of the site. **Upload files** adds several at once. Click a file to see its **Address to use in content** (with a copy button) and to edit its description.
- **Administration > Activity log**: every change and every sign-in with **When**, **Who**, **Event**, **What**, **Page / item**, **Field** and **New value**; click **View** on a line to see the text before and after the change. A "login" line is written as soon as the password is accepted, also when the second (code) step was not completed afterwards. Useful to find out what changed or to copy back an older text. The page editor also has a **Change history** button for that page.

## 12. Build your own pages and add sections (page builder)

The page builder lets you make **new pages** from ready-made sections, and **add sections** to the 15 existing pages. Every section is already designed in the site's dark style: you choose a section, fill in its texts, pictures and links, and put the sections in the order you want. A preview shows the result before anyone else sees it.

### Make a new page

1. Left menu: **Website > Pages**, then **New page** (top right).
2. **Page name**: for example "Dealer financing". The **Address (URL)** is filled in for you from the name ("dealer-financing"). Under the box you see the full address, for example `https://idealers.net/dealer-financing/`, or a short message if the address cannot be used (for example because another page already uses it). Addresses use lowercase letters, digits and hyphens; one "/" is allowed for a sub-page, for example `solutions/financing`.
3. **Start from**: leave **An empty page**, or pick an existing builder page to start with a copy of its sections.
4. Press **Create and open the page builder**. The page is a **draft**: nobody can see it yet.

Pages you made appear in the **Pages** list with the group **built here** and a **Status** (Draft, Published, or Published with unpublished changes). On their row: **Edit**, **View** (when published), **Duplicate**, **Publish** / **Unpublish** and **Delete** (each asks you to confirm).

### Add and arrange sections

The page builder screen has the form on the left and the **Preview** on the right (below the form on a small screen).

- **Add section** opens the list of sections, grouped by kind (Hero, Text and pictures, Scenes, Proof and conversion, Layout). Each one has a short description. Type in the search box to find one ("price", "video"...). Click a section to add it at the end; it starts with example content so you see it in the preview straight away. Between two sections, the **+** button inserts a section at that place.
- Click a section's title bar to open or close it. The title bar shows the kind of section and its first text, for example "Statement: Built for dealers".
- **Move**: drag the section by the arrows icon, or use the up and down arrows.
- **Duplicate**: the two-squares icon copies the section below.
- **Hide**: the eye icon (or the **Hidden** switch inside the section) keeps the section in the builder but does not show it on the page; "(hidden)" appears in its title bar. Click again to show it.
- **Delete**: the bin icon, then confirm.
- Fill in the fields inside a section as on the other pages. Pictures and videos have the same **Upload** and **Library** buttons. Choices such as "Which form" or "Device" are lists to pick from.

The first section that has a big heading becomes the page's main heading. If your page has none, the page name is shown as the heading at the top.

### Preview

The preview shows the page as it would look **with your unsaved changes**. It updates by itself about a second after you stop typing, and right away when you add, move, hide or delete a section.

- **Desktop**, **Tablet**, **Phone**: see the page at that screen width.
- **Open in new tab**: the same preview in a full browser tab (only you can open it, and only while you are signed in).
- **Hide preview** / **Show preview**: more room for the form.

### Draft and publish

- **Save draft** (or Ctrl+S) keeps your work. The live page does **not** change.
- **Publish page** / **Publish changes** puts exactly what you see in the preview on the website (you are asked to confirm). The page then appears at its address and in the sitemap for Google.
- **Discard draft** throws away the unpublished changes and goes back to what is live.
- The coloured box at the top always tells you where you are: **Not published**, **You are editing the draft. It has unpublished changes**, or **Published. You are looking at what visitors see.**
- If you leave the screen with unsaved changes, the admin warns you first.
- **Unpublish** (top right) takes the page off the website; visitors then get "page not found". Its sections are kept.

### Page settings and SEO

The tab **Page settings and SEO** has the **Page name** and the same search-engine fields as the other pages: **Page title** (empty = the page name; " - iDealers A Modern Dealership Software" is added for you, and the box shows the result), **Meta description**, **Social sharing image** (empty = the site's default picture) and **Search engine indexing**. A page set to "Hide from search results" is also left out of the sitemap. These settings are saved with **Save draft** or **Publish** and are live whenever the page is published.

### Change the address of a page

Press **Change address** (top right), type the new address and keep **Send visitors and search engines from the old address to the new one** ticked once the page has been published. The old address then sends visitors to the new one (you find this redirect under **SEO > Redirects**). Under **More** you also find **Duplicate page**, **Change history** and **Delete page**.

### Add sections to an existing page

The 15 original pages keep their designed parts exactly as they are: the builder cannot move, change or remove them (their texts and pictures stay under **Content**). You can add your own sections **between** them.

1. **Website > Pages**, then **Sections** on the page's row (or **Sections** at the top of the page's editor).
2. The screen lists the places where sections can go, from the top of the page to the bottom, for example "After the hero (title and intro)", "After the team picture", "At the end of the page (before the footer)".
3. In a place, press **Add section** and work exactly as on a builder page. The preview shows the whole page, with a thin dashed label at every place so you see where your sections land (the labels are only in the preview).
4. **Save draft**, **Publish sections** and **Discard draft** work as described above, for all places of that page at once.

Places without sections add nothing to the page.

### Put a new page in the menu

The menus are edited where they always are: **Website > Pages > Global**, section **Header**. Add a row to the **Products menu** or the **Company menu** list with the label and the short address of your page (for example `/dealer-financing/`) and press **Save changes**. For the footer, add a row to one of the link lists in the **Footer** section of **Global**. Publish the page first, so the menu never links to a page that is not live.

### What the builder deliberately cannot do

To keep the site fast, safe and true to its design:

- no free layouts (rows, columns, free positioning) and no free colours, fonts or sizes: each section brings its own design;
- no code: no HTML, scripts or embed codes. Text formatting is limited to bold, italic, links, lists and headings; links must start with `/`, `https://`, `mailto:` or `tel:`;
- forms are the three iDealers forms only (Contact, Request a demo, Talk to sales), chosen from a list;
- the designed parts of the 15 original pages cannot be removed or reordered;
- addresses used by the website itself (for example `/admin/`, `/media/`, old WordPress addresses, an existing page or an active redirect) cannot be used for a new page;
- at most 60 sections per page and 50 rows per list.

Every change (draft, publish, address, delete) is recorded in the **Activity log** under "Page built here" or "Page sections".

## If something goes wrong

- A page looks wrong after an edit: open the field you changed and press **Reset to original**, or copy the "Before" text from the Activity log.
- You are locked out: wait 15 minutes, or ask your developer to reset your password.
- Anything else: contact your developer with the page address, what you changed and a screenshot.
