Girişim Teknoloji

Orvia theme documentation

Welcome to Orvia. This guide covers installing the theme, setting up every section, the settings for selling in Türkiye, and answers to common questions.

Contents

  1. Getting started
  2. Theme settings
  3. Header and footer
  4. Home page sections
  5. Product page
  6. Collection, search and cart
  7. Other pages
  8. Selling in Türkiye
  9. Languages and international selling
  10. Apps and metafields
  11. FAQ
  12. Support

1. Getting started

Install Orvia

  1. In the Shopify Theme Store, open Orvia and choose a style: Orvia, Vellum, Marigold or Juniper.
  2. Click Try theme to add it to your theme library, or buy it to publish.
  3. In Shopify admin, go to Online Store > Themes, find Orvia and click Customize.
  4. When you're happy, click Publish.

Each style installs with the same layout, colors and fonts as its demo store. Demo images don't transfer, so add your own images in the theme editor.

Before you start

Update Orvia

When a new version is released, Shopify shows an update notice in Online Store > Themes. Updating adds a new copy of the theme with your settings carried over. Check the copy, then publish it. Code edits aren't carried over.

2. Theme settings

Open Customize > Theme settings (the gear icon).

Colors

Setting Used for
Background / Text Page background and main text
Accent / Button text Buttons, links, highlights and the text on them
Urgency background / Urgency text Countdown strip, low stock and shipping cutoff messages
Card background Cards, panels and soft backgrounds
Borders Dividers and outlines

Some sections, such as Countdown banner, Icon strip, Comparison table and Bought together, have their own color settings.

Typography

Layout

Cart

WhatsApp button

Social media

Add the full URLs of your Instagram, Facebook, TikTok, YouTube, Pinterest and X profiles. Icons appear in the footer brand block for each filled-in link.

Announcement bar

Add one Text block per message, each with an optional Link and Icon.

The header includes predictive search, the customer account button (when customer accounts are on) and the cart icon.

Section settings:

Blocks:

Newsletter popup

Uses Shopify's Customer Privacy API. It only appears where Shopify says consent is required. Set the regions in Settings > Customer privacy.

4. Home page sections

Add sections with Add section in the theme editor. Most sections also work on product, collection and other pages.

Section What it does Key settings
Image banner Full-width image with heading and button Image (set a focal point in the image picker), Heading, Body text, Button label, Button link
Slideshow Rotating image slides Height; Auto-rotate slides (pauses on hover, on focus and when reduced motion is preferred); Change slides every. Slide block: Image, Heading, Text, Button label, Button link, Content position, Text color
Featured collection Product grid from a collection Heading, Collection, Maximum products
Icon strip Row of short store promises Mobile layout (Scrolling row or Two columns), colors. Icon block: Icon or Custom icon, Text
Scrolling text Moving band of short messages Style, Loop duration, Direction, Pause on hover. Text block: Text, Link, Icon
Countdown banner Counts down to a real end date Style (Large boxes or Compact strip), Heading, End date (YYYY-MM-DD), End time (HH:MM, store time zone), Show days, Text below timer, When the timer ends (Hide or Show message), colors. The timer never restarts
Before and after Drag slider comparing two images Eyebrow, Heading, Body text, Before image or label, After image or label, Starting position
Image with hotspots Clickable product dots on an image Heading, Image. Hotspot block: Product, Label when no product is selected, Horizontal position, Vertical position
Comparison table Compare your product with alternatives Heading, Subheading, Feature rows (one per line), colors. Column block: Image, Heading, Highlight column, Values (one per line in row order: + check, - cross, or short text)
Results with bars Percentage bars with an image Image, Heading on image, Eyebrow, Heading, Body text, Footnote. Result block: Percentage, Label, Description. Only publish results you can document
Testimonials Customer quotes Heading. Testimonial block: Quote, Name, Stars, Photo. Use real quotes from your customers
Logo strip Press, partner or brand logos Heading, Enable scrolling, Loop duration, Show logos in grayscale, Logo height. Logo block: Image, Name (used as alt text), Link
Video reels Vertical videos Eyebrow, Heading. Video block: Video (9:16, uploaded to Shopify, loads only when played), Cover image when no video, Title, Product
FAQ Questions and answers Heading, Subheading, Open first question, Enable FAQ structured data (enable it in only one FAQ section per page). Question block: Question, Answer
Recently viewed Products the shopper viewed Heading, Products to show, Save the current product to history. History stays in the shopper's browser
Product recommendations Related or complementary products Heading, Recommendation type, Maximum products
Custom Liquid Your own Liquid, HTML or app code Custom Liquid
Apps Area for app blocks Add app blocks inside it

5. Product page

Open a product in the theme editor (top dropdown: Products > Default product).

Product information section

Blocks

Drag blocks to reorder them.

Block Notes
Title, Vendor, Price, Description Price shows compare-at price, unit price, "taxes included" (when your prices include tax) and the Shop Pay Installments message
Product rating Shows the standard rating metafields filled by your review app
Variant picker Style (Buttons or Dropdown); Show swatches (uses swatches set on product option values in Shopify admin); Swatch option names (default Color, Colour, Renk); Use variant image as swatch fallback; Swatch shape; Size chart page, Show link next to options, Link label
Quantity breaks See below
Buy buttons Show dynamic checkout buttons (on by default); Pre-order (button text changes when a variant is out of stock and "Continue selling when out of stock" is on, plus an estimated shipping note); Show pickup availability
Rating and offer pill Product rating plus a short offer text. Describe a real discount that is active in your store
Social proof Short text with avatars. Use real, verifiable numbers only
Payment icons, Trust badges, Info box Payment logos, up to 6 icon rows, or rows written as icon or emoji \| title \| subtitle
Low stock message Shows only when Shopify tracks inventory and real stock is at or below Stock threshold
Countdown timer Same settings as the Countdown banner section, as a strip or large boxes on the product page
Same-day shipping timer "Order within … to ship today", based on Cutoff hour, Ship on Saturday and Ship on Sunday in your store time zone
Estimated delivery Date range from your cutoff and Minimum or Maximum business days. Weekends are skipped
Bundle contents Lists components of products made with the Shopify Bundles app
Complementary products Products set in the Shopify Search & Discovery app
Collapsible row, Text Extra content, or the content of a page
FAQ Reads the product metafield custom.faq (see section 10)
Ingredients / nutrition Rich text or a connected metafield, with fallback to custom.ingredients
Product tabs Description as the first tab plus up to 3 tabs (text or a page)
Custom Liquid, Apps For app widgets, such as reviews or a cash on delivery form

Quantity breaks (bundle cards)

Bundle cards let shoppers pick a quantity tier. The displayed prices come from the discounts you enter in the block, so you must create a matching discount in Shopify admin. Otherwise the cart charges the normal price.

  1. Go to Discounts > Create discount > Amount off products. Choose Automatic discount, the product, and Minimum quantity of items (for example 2). Set the same percentage or amount as Tier 2. Repeat for each tier.
  2. In the block, set Discount type (Percentage or Fixed amount per item), Show savings as, Selected by default, Show images and Note.
  3. For each tier: Quantity (0 hides the tier), Title, Badge (for example "Most popular"), Discount per item, Show free shipping tag, Image.
  4. Gift or add-on product: choose a product and a Gift behavior (Optional checkbox or Added automatically). The gift is added as its own cart line at its real price. To make it free, create a Buy X get Y discount, then turn on Show gift as free.

Bought together section

6. Collection, search and cart

Product grid (collection pages)

Search results show products, articles and pages. The header's predictive search suggests search terms, products, collections, pages and articles as you type.

Cart drawer

Theme settings > Cart type: Drawer, then open the Cart drawer section from any page.

Cart page

Shows line items, discounts, subscriptions (selling plans), the order note, taxes and accelerated checkout buttons.

7. Other pages

8. Selling in Türkiye

Need How to do it in Orvia
Turkish storefront Go to Settings > Languages, add Turkish and publish it, or set it as the default. All Orvia texts are already translated. Edit them in Online Store > Themes > … > Edit default theme content
TL prices Set the store currency to TRY in Settings > Store details. Orvia shows prices in your store's money format (Settings > General > Currency display, for example {{amount_with_comma_separator}} TL)
KDV-included prices Turn on "Include tax in prices" in Settings > Taxes and duties. Orvia then shows the "taxes included" message on product and cart
ETBİS Add the ETBİS block to the footer. Upload your ETBİS QR image, add the verification link from your ETBİS registration, and type your registration details in Body text
KVKK Create your privacy notice (Aydınlatma Metni) page, then choose it in Cookie banner > Privacy notice page (KVKK). Add it to a footer menu too
Mesafeli satış sözleşmesi, ön bilgilendirme formu, iade koşulları Create them as pages (Online Store > Pages) or Shopify policies (Settings > Policies). Add a "Legal" (Yasal) menu block to the footer
WhatsApp Theme settings > WhatsApp button, plus the WhatsApp Phone number in the footer Brand block
Cash on delivery (kapıda ödeme) Install a cash on delivery app from the Shopify App Store. Add its app block to the Product information section (or an Apps section). You can also use Shopify's built-in manual payment method "Cash on Delivery (COD)" in Settings > Payments
Local payment providers (PayTR, iyzico, etc.) Install the provider's Shopify payment app. Turn on Also show payment methods enabled in your store for payment icons
Troy card icon Tick Troy in the payment icon settings (footer, cart drawer or Payment icons block)
Il / ilçe addresses Address fields are part of Shopify checkout and customer accounts, so the theme doesn't control them. Set address formats in Settings > Markets and in checkout settings
Same-day shipping and delivery dates Product page blocks Same-day shipping timer and Estimated delivery use your store time zone (Settings > General, for example Istanbul)

9. Languages and international selling

10. Apps and metafields

App blocks: Add app blocks in Product information, Newsletter popup and the Apps section. Use Custom Liquid blocks or sections for apps that give you a code snippet.

Optional metafields (create them in Settings > Custom data > Products):

Metafield Type Used by
reviews.rating, reviews.rating_count Standard rating metafields, filled by review apps Product rating, Rating and offer pill, product cards
custom.ingredients Rich text Ingredients / nutrition block (fallback)
custom.faq List of metaobject entries with question and answer fields Product FAQ block
custom.bundle_products List of products Bought together section

11. FAQ

Why doesn't the bundle price match the cart total? Bundle cards and Bought together show the discount you type in the block, but Shopify only charges discounts that exist in Discounts. Create the matching automatic discount (see section 5).

My countdown disappeared. The end date has passed. Set a new End date and End time, or choose Show message under When the timer ends. Orvia countdowns never restart by themselves. This is intentional and follows Shopify's rules against fake urgency.

The low stock message doesn't appear. It only appears when the variant tracks inventory, "Continue selling when out of stock" is off, and real stock is at or below the threshold.

The free shipping bar is missing. Check Theme settings > Cart > Show free shipping progress bar and the threshold. The bar only shows in your store's default currency and when the cart has items.

Swatches show text instead of colors. Add swatches to the option values in the product's options in Shopify admin, or add variant images and keep Use variant image as swatch fallback on. Make sure the option name is listed in Swatch option names.

Filters don't show on the collection page. Install and set up the free Shopify Search & Discovery app and add filters there.

How do I show the WhatsApp button only on some pages? The floating button shows on all pages when turned on. For a single page, turn it off and add a WhatsApp link in a Custom Liquid block or the footer Brand block.

Can I use Orvia for a store outside Türkiye? Yes. All Türkiye-specific features are optional blocks or settings, and the theme supports any currency, country and language Shopify offers.

Does Orvia include a cash on delivery form? No. Orvia works with cash on delivery apps through app blocks, and with Shopify's built-in manual COD payment method.

Where are my demo images after installing? Demo images don't transfer when you install a theme. Add your own images in the theme editor.

Can I edit the theme code? Yes, but duplicate your theme first. Our support covers Orvia's original code. For custom changes, we recommend hiring a Shopify Partner.

12. Support

Always include your store URL (for example yourstore.myshopify.com), the theme version (Online Store > Themes > … > Theme info) and screenshots.