Storefront Settings

Configure how your embeddable storefront appears and functions on your website. The storefront allows customers to browse products, configure options, and submit orders directly from your existing website.

Navigation: Settings → Orders → Storefront

Storefront URL Configuration

Embed Host URL

Enter the full URL of the page where you've embedded TimberCloud.

Field	Example
Embed Host URL	`https://yoursite.com/orders`

This URL ensures password reset emails return users to the correct page on your website rather than TimberCloud directly.

Selling Mode

Choose how customers interact with your products.

Direct Order

Customers can purchase products directly without requiring manual approval.

Feature	Description
Immediate Checkout	Customers complete payment instantly
Fixed Pricing	Products use configured prices
Best For	Standard products with clear specifications

Requirements:

Stripe payments must be enabled and configured
Payment methods set up in Stripe dashboard

Note: Direct Order is automatically disabled if Stripe payments are not properly configured.

Quote-Based Workflow

Customers submit quote requests that require your review before payment.

Feature	Description
Quote Submission	Customers request quotes instead of immediate purchase
Review Process	You approve, modify, or decline quotes
Flexible Pricing	Adjust pricing before sending to customer
Best For	Custom work, complex orders, or negotiated pricing

Price Visibility

Control how product prices are displayed to customers.

Quote Mode Settings

When using quote-based workflow:

Setting	Behavior
Show Prices	Customers see indicative prices before requesting quotes
Hide Prices	Customers only see "Request Quote" buttons

When to Show Prices:

Products have consistent pricing
You want transparency before quote submission
Reducing back-and-forth on pricing expectations

When to Hide Prices:

Highly customizable products
Pricing varies significantly by specification
Competitive or negotiable pricing

Embed Your Storefront

Add your TimberCloud storefront directly to your website using embed codes.

Embed Options

Iframe Only (Simple)

Best for: Quick setup, broad CMS compatibility

<div
  style="
    position: relative;
    left: 50%;
    right: 50%;
    margin-left: -50vw;
    margin-right: -50vw;
    width: 100vw;
    max-width: 100vw;
    overflow: hidden;
    padding-left: 16px;
    padding-right: 16px;
  "
>
  <iframe
    id="timbercloud-embed"
    src="https://embed.timbercloud.io/your-company-slug"
    width="100%"
    height="1280"
    style="border: none; border-radius: 8px; display: block;"
    title="Product Catalog"
    allow="payment"
    loading="lazy"
  ></iframe>
</div>

Pros:

Works immediately on any website
No scripts that could be blocked by CMS
Full-width responsive design

Cons:

Password reset emails return to homepage

Dynamic Script (Recommended)

Best for: Better user experience, proper routing

<div id="timbercloud-embed"></div>
<script
  src="https://embed.timbercloud.io/embed.js"
  data-company="your-company-slug"
  data-theme="light"
  data-width="100%"
  data-height="1280px"
  defer
></script>

Pros:

Password reset returns to exact page
Better routing and seamless UX
Auto-adjusting height
Cleaner HTML

Cons:

WordPress might strip script tags from Custom HTML blocks

Script Customization Options

Attribute	Values	Description
`data-height`	`1280px`, `1600px`, etc.	Embed height
`data-width`	`100%`, `1200px`, etc.	Embed width
`data-theme`	`light`, `dark`	Color theme
`data-company`	Your company slug	Required identifier

Iframe Customization Options

Property	Description
`height`	Adjust the height attribute (e.g., "1280", "1600")
`padding-left/right`	Adjust mobile gutters (default 16px)
`width`	Uses 100vw for full-width display

Installation Instructions

Standard HTML Website

Choose your embed type (Iframe or Script)
Copy the embed code from Settings
Paste into your HTML where the storefront should appear
Customize dimensions as needed

WordPress

For Script Embed:

Use a plugin like "Insert Headers and Footers"
Or add via theme's functions.php

For Iframe Embed:

Add directly to page using Custom HTML block
Works without script restrictions

Squarespace / Wix / Shopify

Use the Iframe embed method
Add as a custom HTML/embed block
Adjust height to match your page design

Testing Your Embed

Copy your embed code
Paste into your website
Verify the storefront loads correctly
Test product configuration
Test checkout or quote submission
Verify mobile responsiveness

Preview Link

Access your storefront directly:

https://embed.timbercloud.io/your-company-slug

Troubleshooting

Storefront Not Loading

Verify your company slug is correct
Check that your subscription is active
Ensure the embed URL is accessible

Height Issues

Adjust the height or data-height attribute
Consider using auto-height with script embed
Test on different screen sizes

Password Reset Links Wrong

Use the Dynamic Script method
Set your Storefront URL in settings
Verify the embed page URL matches

CMS Blocking Scripts

Switch to Iframe embed method
Use a trusted script insertion plugin
Contact your CMS provider about whitelisting

Related Settings

Order Settings - Order processing configuration
Delivery Options - Shipping method setup
Company Settings - Login bar integration

Tax Settings Account Settings