SARAH
DocumentationAPI Reference

Store Setup

Step-by-step guide to configure your online store in Sarah.

Last updated: 2026-06-29

This guide will help you configure your online store from scratch.

Access to Configuration

  1. Navigate to Settings or Company in the main menu
  2. Look for the "Online Store" or "Shop" section
  3. Or access directly from your store URL and click "Configure"

The screen has a top bar (title, active/closed status, public URL, save) and four tabs:

  • General: URL, domain, social links, and store description
  • Catalog & sales: pricing, stock, pickup, minimum order, and product grid
  • Design: theme, header, marquee, and footer media (Beauty theme)
  • Advanced: analytics scripts and featured highlights (Pro plan)

Basic Configuration

Company Information

Company Name

  • Name that will appear in the store
  • Also used for SEO and metadata

Description (About)

  • Descriptive text about your company
  • Appears on the store page
  • Useful for SEO

Logo

  • Upload your company logo
  • Shown in store header
  • Recommended format: PNG or SVG with transparent background

Header Image

  • Large image that appears at the top
  • Recommended format: 1200x400px or similar
  • Can be a photo of your store, products, etc.

URL and Domain

Store Slug

  • Unique identifier for your store
  • Format: only letters, numbers, and hyphens
  • Resulting URL: https://[slug].sarah.ar

Custom Domain (Optional)

  • If you have your own domain, you can connect it
  • Example: https://store.mycompany.com
  • Requires additional DNS configuration

Online store active

  • Toggle in the Settings → Online Store top bar (next to the public URL)
  • When disabled, the public storefront shows a closed notice and does not accept orders
  • Products and settings are preserved; you can turn it back on anytime

Contact Information

Address

  • Physical address of your business
  • Shown in the store

Phone

  • Contact number
  • May appear in the store

Email

  • Contact email
  • Used for notifications and communication

Product Configuration

Show Prices

Hide Prices

  • If enabled, prices are not shown in the store
  • Useful for B2B businesses that require inquiry

Price List

  • Select which price list to use in the store
  • If none selected, base prices are used

Stock

Sell without Stock

  • If enabled, allows selling products even if there's no stock
  • Useful if you handle orders on demand

Enable Products

  • Only products with enable: true appear in the store
  • Control which products are shown from Inventory module

Payment Configuration

MercadoPago

To accept online payments, you need:

  1. Connect a Cash Register with MercadoPago

    • Go to Cash Registers
    • Create or edit a cash register
    • Connect MercadoPago with your credentials
    • Mark cash register as enabled for store (enable_shop: true)

  2. Multiple Cash Registers

    • You can have several cash registers with MercadoPago
    • Customer can choose which one to pay with

Available Payment Methods

  • MercadoPago QR: Customer scans a QR code
  • Payment Link: A link is generated to pay
  • Cash (Pickup): Only available for store pickup

Shipping Configuration

Enable Shipping

Allow Shipping

  • Activate or deactivate home delivery option
  • If deactivated, only store pickup is allowed

Store Pickup

Allow Pickup

  • Activate or deactivate store pickup option
  • If enabled, customer can choose to pick up at your business

Correo Argentino Integration

To automatically calculate shipping costs:

  1. Go to Settings > Shipping
  2. Add your Correo Argentino credentials
  3. Configure your origin address
  4. Store will calculate costs automatically

Visual Configuration

Theme

Select a predefined theme:

  • Default: Basic and clean theme
  • Dark: Dark theme
  • Other themes available according to your plan

Customization

  • Colors: Customize main colors (if theme allows)
  • Fonts: Select fonts (if available)
  • Layout: Design options (if available)

Additional Features

Marquee (Sliding Banner)

Marquee Text

  • Text shown in a sliding banner
  • Useful for promotions or announcements

Store Features

You can configure features shown in the store:

  • Pick-up at store: Information about pickup
  • Shipping nationwide: Shipping information
  • Multiple payment methods: Payment information
  • Protected purchase: Security information

Each feature can have:

  • Icon: Emoji or icon
  • Title: Feature name
  • Description: Explanatory text
  • Enabled: Activate or deactivate

Installments

Show Installments

  • If enabled, MercadoPago installment information is shown
  • Helps customers understand payment options

SEO and search visibility

Sarah automatically generates SEO resources per store:

Sitemap and robots

  • Each store has its own sitemap.xml with product and public page URLs.
  • The robots.txt file points to the correct sitemap based on the store domain or subdomain.
  • If you use a custom domain, these files respect the configured host.

Structured data

  • Products include structured data (schema.org) to improve how they appear in Google and other search engines.
  • Sarah automatically fills image, description, brand, barcode (GTIN), shipping, and returns when product data is missing.
  • Under Settings → Online Store → Advanced → SEO and Google you can set return days, return shipping cost, shipping cap, and delivery/preparation times that Google reads from the schema.
  • Complements basic store name, description, and logo configuration.

Recommendation: Keep clear descriptions, optimized images, product barcodes, and shipping/return settings aligned with how you actually operate.

Canonical product URLs

Each product has a dedicated page URL:

  • Format: https://[your-store]/?product={id} ({id} is the product's internal numeric identifier).
  • Legacy links: if someone opens /p/{id}, Sarah automatically redirects to ?product={id}.
  • Sharing: share buttons (WhatsApp, etc.) use the product's canonical URL.
  • Sitemap: sitemap.xml lists products in this same format.

Search, category, or pagination pages (?q=, ?category=, ?page=) are not indexed as separate URLs; the canonical points to the store's main listing.

Analytics and tracking

In Settings > Online Store, Analytics and tracking section, you can paste measurement scripts:

What's supported

  • Google Analytics (gtag.js, inline Google Tag Manager, etc.).
  • Meta Pixel and other providers that deliver <script> tags.
  • Scripts with external src or inline code.

How to configure

  1. Copy the code from your provider (GA, Meta, etc.).
  2. Paste it in the Header scripts field.
  3. Save store settings.

Behavior

  • Scripts only run on the public store (what your customers see), not the admin panel.
  • They load after the page has rendered, to avoid hurting speed (LCP).
  • Sarah parses <script> tags from the pasted HTML and injects them in order.

Only paste scripts from trusted providers. A malicious script in this field would affect your store visitors.

Verification

After configuring, verify:

  • ✅ Store URL works
  • ✅ Logo and header display correctly
  • ✅ Products appear in the store
  • ✅ Prices are shown (or hidden) according to configuration
  • ✅ Cart works
  • ✅ Payments are connected (if applicable)

Next Steps