Documentation

Customer experience and branding

This section controls everything the customer sees and how the quote is presented, priced, delivered, and branded. The pages live under Customer Experience in the Configuration sidebar, plus Company Profile under Settings.

To reach these pages, open Configuration in the app's left navigation. The pages covered here are grouped under Customer Experience, with the exception of Company Profile which lives under Settings. The Preview page is a top-level item in the app's left nav.

System Overview

Open Customer Experience > System Overview.

The System Overview is the summary block shown to the customer at the top of the storefront sidebar (panel power, total panels, system size). You can:

The System Overview page in Solvera's admin. The page shows Show system summary selected, then a list of toggle fields for Panel STC Power, Total Number of Panels, System Size STC, System Size PTC, and System Size kW. Two are checked with editable Custom label inputs. Below that is an Add Custom Summary Line button
The System Overview page. Enabled fields appear in the storefront sidebar; disabled ones do not. Each enabled field has a Custom label input that overrides the default display name. Custom Summary Lines are added below (Professional).

Quote Display

Open Quote Display under Customer Experience. This controls how the calculated bill of materials appears in two places: the storefront sidebar during the wizard, and the final quote page. Most options can be set separately for each location.

The Quote Display page in Solvera's admin. The top of the page shows Show BOM in sidebar selected. Below is a visibility table with rows for Show unit price, Show line total, Show grand total, Show product links, and Show product thumbnail images, with toggle checkboxes for Sidebar BOM and Final Quote Page columns. Below that is a Disclaimer Line text field and the Unmatched items setting with two radio options: Show as Price on request (selected) and Hide from customer quote
The Quote Display page. The visibility matrix lets you show pricing on the final quote but hide it from the live sidebar (a common pattern for lead-capture flows), or any other combination. The Disclaimer Line and the Unmatched items setting are below.

Quote Pricing Growth+

Open Quote Pricing under Customer Experience. Add tax, shipping, and surcharges to quotes.

When pricing is configured, the customer-facing quote shows a clear breakdown: subtotal, then each enabled surcharge, then shipping, then tax, then the estimated total.

The Quote Pricing page in Solvera's admin. Three sections are visible: a Tax section with Show estimated tax (percentage) selected at 4 percent with Allow sales rep to edit rate per quote checked; a Shipping Estimate section with Tiered rates selected, Tier basis set to Total weight (lbs), and two tiers configured; and a Quote Surcharges section with a Shipping insurance surcharge at 1.8 percent of subtotal, default On with rep can toggle off
The Quote Pricing page in a configured state. Tax is set to 4% (with rep override allowed), shipping uses weight-based tiers, and a 1.8% shipping insurance surcharge is added with a default-on rep toggle.

Quote Delivery

Open Quote Delivery under Customer Experience. This page controls how quotes are delivered, shared, and notified, across five areas, in the order they appear down the page.

Email delivery

Turn on Customer self-service emails to let customers email a quote to themselves from the storefront. The quote is sent to the customer's logged-in account email, so customers sign in (or create an account) before emailing a quote to themselves. Set a reply-to email so their replies reach you. Sending email requires an email provider key on the server. If email is on but the key is missing, the page shows a warning banner. Share links and add-to-cart do not require email.

Email templates

When customer emails are on (or you have Sales Mode), an Email Templates card appears with up to two tabs:

Each tab has a subject line and a body, edited in a rich editor where merge tags appear as chips you insert from a palette. Customer tags include the customer first name, full name, company name, and quote reference. The sales tab adds the rep name and also has a rep signature field. A field you have changed grows a "Reset to default" link beside its label, so you can revert one edit without losing the others. Fields still at their default show no link.

ZIP or postal code Growth+

Turn on Ask customers for their ZIP code when emailing a quote to add an optional field to the Email your quote card for logged-in customers. Stores in the United States see "ZIP code" with US validation; stores elsewhere see "Postal code". The value is saved with the quote and returned by the API. It is optional, never blocks the send, and does not change the quote's pricing. The card appears only when Quote Pricing is available on your plan.

Quote page URL

Quote page URL is the one setting on this page you have to fill in by hand for the "View Your Quote" button in quote emails to work. It is not a link to a quote. It is the address of the page on your storefront where your customers use the configurator, for example https://your-store.com/pages/solar-design-quote.

How the link is built

Solvera does not host a separate page for each quote. Every saved quote gets a reference like SQ-4F2A9C, and the link Solvera emails is your own configurator page with that reference added to the end:

https://your-store.com/pages/solar-design-quote?quote=SQ-4F2A9C
[------------ what you enter in the field -----------][- Solvera -]

The part after the question mark is a URL parameter: extra information tacked onto the end of a web address that tells the page what to show. You never write it yourself, and you should not try to. Solvera adds ?quote= and the reference to each quote it sends. All you supply is the page address in front of it.

When a customer opens that link, your page loads as normal, the configurator on it notices the quote reference, and instead of starting a blank design it shows the saved quote. That is why the address has to be the page the configurator actually lives on. Your store's home page, an "about us" page, or a link to the app in your Shopify admin will not work, because there is no configurator on those pages to read the reference.

Finding your page address

  1. Open your live storefront the way a customer would, and go to the page where they design their system.
  2. Copy the whole address out of your browser's address bar.
  3. If the address you copied has a ? in it, that part is not needed. Solvera drops anything after a ? or a # when it saves the setting, so it is safe to paste a link you copied out of an earlier quote email.
  4. Paste it into Quote page URL and save.

The address has to be a full one starting with http:// or https://. A partial address such as your-store.com/pages/solar or /pages/solar is rejected: the field turns red with "Enter a full address starting with http:// or https://", and pressing Save scrolls you back to the field instead of saving.

If Solvera has already seen your configurator running on your storefront and the field is empty, it offers what it found underneath the field, as "Detected on your storefront" with a Use this button that fills the field in for you. Check it before you accept it. It is the first page the configurator was ever seen on, which is not always the page you want customers sent to. Merchants who also embed the configurator on their home page usually see the home page suggested here.

If you leave it blank

Nothing breaks, but quote emails go out without the "View Your Quote" button. Solvera leaves the button out rather than guessing an address, because a button that lands the customer on the wrong page looks worse than no button at all. Customers can still read the quote in the body of the email.

The setting matters most for sales reps. When a customer emails a quote to themselves from your storefront, Solvera already knows which page they were standing on and uses that, falling back to this setting. A sales rep sends from inside the Shopify admin, where there is no storefront page to read, so this setting is the only thing that can supply the address. If you have Sales Mode and the field is empty, the Quote Delivery page shows a warning saying sales rep quote emails are being sent without a "View Your Quote" link. Growth+

Admin alerts

Turn on Send admin alerts to get an email when a customer submits a new quote or a sales rep sends one. Set an alert recipient (it defaults to your Company Email from Company Profile if left blank). The sub-option Also notify on first quote view sends one alert the first time a customer opens a shareable quote link; later views do not re-trigger it. Alert subjects start with "Solvera alert" so they are easy to filter. Admin alerts also require the email provider key.

The Quote Delivery page in Solvera's admin. The top shows Customer self-service emails turned on with a reply-to email of quotes at calisgroup.com. Below are two tabs (Customer Self-Service selected, Sales Rep Outreach available), then Subject line and Body text fields with merge tag chips for First Name, Full Name, Company Name, and Quote Ref. Below that, toggles for Share This Quote button (on), Shareable link in quote email (on) with a Link expiry days field set to Never, and Send admin alerts (on) with an Alert recipient field showing solvera at calisgroup.com a ZIP code card with the toggle Ask customers for their ZIP code when emailing a quote, and a sub-option Also notify on first quote view (on)
The Quote Delivery page. Email delivery, email templates, shareable links, and admin alerts are all configured here. Both template tabs work the same way; the Sales Rep Outreach tab is available on Growth and above.

Company Profile

Open Settings > Company Profile.

Enter your company name, phone, email, and footer text. These appear in customer emails and at the bottom of quotes so every quote looks professional and on brand. Any field left blank falls back to your Shopify store details, so you only need to fill in fields where you want a quote-specific override.

The Company Profile page in Solvera's admin. Four fields are visible: Company name, Phone number, Contact email, and Footer text
The Company Profile page. These fields appear in quote emails and the printed quote footer. Leave any field blank to use your Shopify store value as the fallback.

Branding Professional

Open Branding under Customer Experience. Make the storefront and emails match your brand.

Your branding flows into the storefront wizard, saved quote links, and both customer and sales rep quote emails, so the entire experience is yours. Below the Professional plan your logo and colors stay saved but are not applied anywhere; the Publish page notes "Branding not shown - Professional plan required" so you are never surprised by what goes live.

The Branding page in Solvera's admin. The page shows a Merchant logo with a logo uploaded and, beneath it, a Where to show your logo block with two toggles, Storefront configurator and Quote emails, both on; then a Storefront colors section with Accent color and Secondary color pickers, and a live Preview strip showing wizard step tabs, inverter type cards, an Estimated total, and an Add to cart button. At the bottom is a Powered by Solvera toggle
The Branding page with a logo, accent color, and secondary color all set. The Preview strip updates immediately so you can confirm contrast and tone before publishing.

Preview

Open Preview from the app's left navigation (a top-level item, not nested under Configuration).

Preview renders the full configurator inside the admin against your current unpublished state, so you can test changes before customers see them. No publish is required.

An Unpublished badge appears next to the title whenever you have edits that are not live yet, so you can tell at a glance whether what you are looking at differs from your storefront.

The Configurator Preview page in Solvera's admin. The toolbar reads Configurator Preview with an Unpublished badge, then Desktop selected over Tablet and Phone, a 17 customizations indicator, a Learn more link, and Explain BOM, Edit Mode, Refresh, Publish and Ask Solvera buttons, with Explain BOM and Edit Mode both switched off. Below, the configurator renders cleanly with the merchant's logo and six step tabs reading Choose Components, Solar Panels, Racking, Inverters, BOS and Review. The first step is headed Step 1 of 6, Choose Your System Components, with a Full system and Choose components switch set to Full system and the note All four included, above four rows for Solar Panels, Racking, Inverters and BOS, each with an icon, a one-line description and a ticked checkbox at the right.
The Preview page in Desktop mode with both toolbar tools off, which is exactly what a customer would see. The toolbar stays fixed while the configurator scrolls in the iframe. Switch device sizes to verify layout, use Refresh to load draft changes, and use Publish when you are ready to ship them live.

Explain BOM

Explain BOM tells you why each line is in the quote. The Explain BOM button sits in the Preview toolbar beside Edit Mode and reads Explaining while it is on. It is off by default, and while it is off the quote panel is exactly what customers see.

Turn it on and every line in Your Quote gets a small ? button. Click it — hovering does nothing — to open a panel explaining that line, from the top:

Only the checks that carry information are shown, so a straightforward line has a short panel. When the engine has combined two item types onto one product, such as mid and end clamps that are the same part, the panel says "This line combines 2 item types" and explains each one separately, headed by what produced it and the item type's name ("Quantity rule - Mid Clamps"). On the panel line, a minimum order quantity that raised the count adds "Minimum order applied to this line only."

The Configurator Preview page with Explain BOM turned on, so the toolbar button reads Explaining and is highlighted, beside Edit Mode, Refresh, Publish and Ask Solvera. The configurator shows the Racking step, and in the Your Quote panel on the right every line carries a small question mark button beside its quantity. One panel is open over the quote. It is headed Racking, Rail System, Splices with a close cross, then a line reading product 1 of 2, IronRidge XR100 BOSS Aluminum Bonded Splice Mounting Rail, and a grey line repeating the same path and position. Three labelled rows follow: RULE 1 OF 1 reading No condition; PICKED reading Matched Racking Manufacturer = IronRidge, Rail Profile = XR100, 2 candidates; and QTY reading 10 = the sum of rails minus 1 times 2 per row, with 1 row beneath it. An Open row button and a Close button sit at the bottom of the panel.
Explain BOM open on a splice line. The panel names the table the product came from and its position in it, the quantity rule that fired, the criteria that picked this product out of the two candidates, and the formula behind the quantity of 10. Open row goes straight to that product's row in the catalog.

One panel is open at a time. Esc, a click outside it, the × or Close closes it, and it closes by itself when the quote recalculates. It works at the Tablet and Phone preview sizes as well as Desktop, and Edit Mode and Explain BOM can be on at the same time.

Explain BOM is a Preview tool. It never appears on the live storefront, in shared quote links or in emails, and there is nothing to publish: turn it on and it is there. To find every table a product sits in, rather than the reason for one line, use Catalog search.

Content editing in Preview Professional

Inside Preview, Professional merchants can turn on Edit Mode to customize the storefront text and visuals without code. The toolbar button reads Edit Mode when it is off and Editing while it is on, and a counter beside it shows how many customizations are waiting in the current draft.

This is how you localize, rephrase, or rebrand any visible string in the configurator. Edits are saved as overrides, so you can revert any one of them without affecting the others. Use Refresh to see how an edit reads in the actual flow, and Publish when you are ready to push the overrides live.

The Configurator Preview page with Edit Mode active, so the toolbar button reads Editing and is highlighted, with a 17 customizations badge to its left and the Explain BOM button beside it switched off. Inside the preview every editable element carries a dashed gold outline and a small pencil badge: the six wizard step tabs, both Next buttons, the step title Choose Your System Components and the description line under it, the Full system and Choose components pills, and the icon, name and description of each of the four module rows for Solar Panels, Racking, Inverters and BOS. The ticked checkboxes at the right of each row carry no outline, because they are a control rather than content.
The Preview page with Edit Mode active and Explain BOM off; the two are independent and can be used together. Every dashed outline marks an editable piece of text or image. Click any one to open an inline editor for that element. The customizations counter in the toolbar tracks how many overrides are pending in the current draft.

Reordering options

Edit Mode also controls the order of the options inside a question: manufacturer cards, mount types, inverter types, and the options of any custom question you have written. The order is stored per question, so inverter manufacturers and battery manufacturers are ordered independently of each other.

The first option in a question is the one selected by default when a customer has not chosen yet, so reordering is not purely cosmetic: moving a different manufacturer to the front changes the default bill of materials and the starting quote total. The editor says so at the point of the edit.

Options you add later are appended to the end of the order you set, not inserted alphabetically. If you add a new manufacturer to your catalog after curating an order, it lands last until you move it.

A move shows immediately in the preview so you can see the result, and lands in the save bar with your other draft edits: click Save to keep it or Discard to put it back. Publish to push a new order to your live storefront.

Product cards that come from your catalog, such as solar panels, inverters and batteries, are not reordered here. Their order comes from the row order of the product table on the module's page; see Product order.

Putting it together

A typical setup pass through this section looks like:

  1. Set your Company Profile and (Professional) upload your logo and colors.
  2. Decide what shows in the BOM sidebar and the final quote, using the Quote Display matrix.
  3. Configure pricing if you are on Growth or above (tax, shipping, surcharges).
  4. Write your email templates and turn on the share and admin alert options you want.
  5. Preview the whole experience at all three device widths.
  6. Edit any text in Preview (Professional) to fit your audience.
  7. Publish when everything looks right.