Guide Shopify

Installer l'application Shopify DecorViz

Installez l'application depuis le Shopify App Store, activez un app embed, et un bouton « Voir dans votre pièce » apparaît sur vos pages produits. Aucun code de thème, aucune configuration produit par produit, tout se passe dans votre admin Shopify.

Installation en 5 min
Mis à jour août 2026
Shopify App Store

Aperçu

L'application DecorViz: Furniture Visualizer ajoute un bouton « Voir dans votre pièce » à vos pages produits Shopify. L'acheteur le sélectionne, téléverse une photo de sa propre pièce et obtient un aperçu réaliste du produit dans son espace avant de se décider.

Elle travaille à partir de la photo produit déjà publiée sur la page. Aucun modèle 3D à commander, aucun flux produit à mapper et aucune configuration produit par produit : une fois l'app embed activé, toutes les pages produits éligibles sont couvertes, y compris les produits ajoutés plus tard.

Toute la configuration se fait dans votre admin Shopify. Vous n'ouvrez jamais un fichier de thème.

Vous n'êtes pas sur Shopify ?

Les boutiques WooCommerce, Wix, Squarespace et codées sur mesure installent Storefront avec un seul script depuis le tableau de bord web DecorViz. C'est expliqué dans le guide d'installation Storefront.

Aucun code de thème

L'app embed s'active depuis l'éditeur de thème et se désactive de la même façon.

Aucun travail produit par produit

DecorViz détecte seul les produits éligibles. Vous n'ouvrez la page Products que pour masquer le bouton sur certains articles.

Les photos des acheteurs restent privées

Les photos de pièce servent uniquement à générer l'aperçu et ne vous sont accessibles ni dans l'application ni dans les statistiques.

Avant de commencer

Il y a très peu à préparer :

  • Une boutique Shopify que vous administrez. Il vous faut le droit d'installer des applications et de modifier le thème.
  • Un thème Shopify que vous pouvez personnaliser. Les app embeds fonctionnent avec les thèmes vintage comme avec les thèmes Online Store 2.0, aucune mise à niveau du thème n'est donc nécessaire.
  • Des pages produits avec une photo produit nette. Storefront lit l'image directement sur la page : une photo produit propre et bien éclairée est la seule matière première nécessaire.
Pas besoin d'un compte DecorViz au préalable

L'application utilise l'adresse e-mail du propriétaire de votre boutique Shopify pour créer ou associer un compte DecorViz après l'installation. Si vous êtes déjà abonné au forfait Storefront sur decorviz.ai, installez avec cette même adresse et l'application fonctionnera avec le forfait que vous payez déjà.

Installation

Quatre étapes, du début à la fin. Deux sont obligatoires, et l'application vous indique quand votre clé est prête.

Étape 1 : Installer l'application

1

Installer depuis le Shopify App Store

Ouvrez la fiche DecorViz: Furniture Visualizer et installez l'application sur votre boutique. L'application demande uniquement un accès en lecture aux produits, afin de constituer la liste des catégories et de vous permettre d'exclure certains articles. Elle n'écrit jamais dans votre catalogue et ne touche jamais aux commandes ni aux clients.

Vous démarrez sur le forfait Free

Les nouvelles installations démarrent avec 5 aperçus d'essai et sans facturation Shopify. C'est suffisant pour mettre le bouton en ligne et le tester sur vos propres produits avant de choisir un forfait.

Étape 2 : Copier la clé d'installation

2

Ouvrir Installation dans l'application

Ouvrez DecorViz depuis Apps dans votre admin Shopify, puis allez dans Installation. Votre clé d'installation y figure, avec la mention Key ready une fois la boutique connectée. Copiez-la.

Shopify admin: Apps → DecorViz: Furniture Visualizer → Installation
Installation guide
2 required steps

Turn on the embed, then check a product page.

1 Turn on DecorViz Storefront Key ready

Open your theme editor, go to App embeds, switch on DecorViz Storefront, and paste your install key into it.

Install key
8f3c2a10-5b7e-4d91-a6c4-2e0b71d94f38

Copy this into DecorViz Storefront in your theme editor.

Open theme editor → Button settings →
C'est la mention « Key ready » qu'il faut repérer

Elle signifie que votre boutique est connectée et que la clé est active. DecorViz ne vérifie pas actuellement si l'embed lui-même a été activé et enregistré, l'application ne peut donc pas confirmer cette partie à votre place. C'est le rôle de l'étape 4.

Étape 3 : Activer l'app embed

3

Activer DecorViz Storefront dans l'éditeur de thème

Sélectionnez Open theme editor dans l'application, ou allez dans Online Store → Themes et choisissez Customize sur votre thème en ligne. Ouvrez App embeds dans la barre latérale, activez DecorViz Storefront, collez votre clé dans le champ Install key, puis cliquez sur Save.

Shopify: Theme editor
Sections
Header
Product information
App embeds
DecorViz Storefront ✓
DecorViz Storefront On

Shows a Preview button on suitable product pages. Shoppers upload a photo of their space and see your furniture there.

Install key
8f3c2a10-5b7e-4d91-a6c4-2e0b71d94f38
Les app embeds sont enregistrés par thème

Le réglage appartient au thème dans lequel vous l'avez activé. Si vous publiez un autre thème par la suite, ouvrez son éditeur, activez-y DecorViz Storefront et collez la même clé d'installation. Vos réglages de bouton et vos exclusions de produits ne changent pas.

Étape 4 : Tester une page produit

4

Générez votre premier aperçu

Ouvrez une page produit sur l'URL en ligne de votre boutique, pas dans l'éditeur de thème ni dans un aperçu de brouillon. Vérifiez que le bouton Preview apparaît là où vous l'attendez, puis téléversez une photo de pièce et générez un aperçu de bout en bout.

Voici ce que vous cherchez. Le bouton Preview se place dans la rangée de boutons de votre propre thème, à côté d'Ajouter au panier :

Luna & Co. Home
luna-home.myshopify.com
Living Room Dining Lighting Cart (1)
Home / Sofas / Modern Velvet Sofa
Luna Signature Collection
Modern Velvet Sofa - Forest Green
4.8 (126 reviews)
$1,249.00

Premium velvet upholstery with solid wood frame. Available in 4 colors. Free delivery.

Color: Forest Green

Une démo de la vue acheteur. Le texte, la couleur et la position du bouton proviennent de la page Settings de l'application.

Profitez-en pour vérifier plusieurs modèles : un article simple, un article à nombreuses variantes, tout ce qui est sur mesure, et au moins une page sur mobile. Ouvrez ensuite une page non-produit comme votre page d'accueil et vérifiez que le bouton n'y apparaît pas.

L'installation est terminée

Tout ce qui suit relève du réglage facultatif. Le bouton est déjà actif sur vos pages produits.

Réglages du bouton

Ouvrez Settings dans l'application pour que le bouton s'intègre à votre thème plutôt que d'y être rapporté. Ces réglages vivent dans l'application, pas dans l'éditeur de thème : il n'y a donc qu'un seul endroit où les modifier.

  • Button text. Ce que les acheteurs voient sur le bouton Preview, jusqu'à 60 caractères.
  • Style et Corners. Plein ou contour, et la forme des angles.
  • Colour et Drop shadow. Une valeur hexadécimale plus une ombre facultative.
  • Match my theme. Reprend le rayon des angles, la police, la hauteur et la couleur de vos propres boutons d'achat, pour ne pas avoir à les aligner à la main. Style s'applique par-dessus : Filled copie votre bouton Acheter maintenant, Outline copie Ajouter au panier.
  • Position. L'emplacement du bouton dans la zone d'achat. Above Add to cart est le réglage recommandé et la première chose que les acheteurs y voient.

Chaque modification s'affiche immédiatement dans le panneau Preview à côté des champs : vous pouvez donc fixer l'apparence sans recharger votre boutique.

Shopify admin: Apps → DecorViz: Furniture Visualizer → Settings
Preview button
Show the Preview button on these categories
▸ Showing on all categories
Status

Show the Preview button on my store

Turning this off hides the Preview button everywhere without uninstalling the app.

Désactiver le bouton sans désinstaller

La section Status en bas de Settings comporte un seul réglage, « Show the Preview button on my store ». Le désactiver masque le bouton Preview partout tout en laissant l'application installée et vos réglages intacts. Préférez cela à une désinstallation si vous voulez simplement retirer le bouton un moment.

Placement sur un thème très personnalisé

Si aucune des options Position ne place le bouton où vous le souhaitez, choisissez l'option personnalisée et donnez à DecorViz un CSS selector désignant l'élément d'ancrage, ainsi que la position avant ou après celui-ci. Vous ne modifiez toujours aucun fichier de thème.

Choisir les produits qui affichent le bouton

Vous n'activez pas les produits un par un. DecorViz détecte les articles éligibles et affiche le bouton Preview automatiquement. Il y a deux façons de restreindre cela :

  • Catégories. Dans Settings, choisissez les catégories sur lesquelles le bouton Preview apparaît. C'est le réglage large, celui qu'utilisent la plupart des boutiques.
  • Produits individuels. Ouvrez Products dans l'application et masquez le bouton sur les articles que vous ne voulez pas inclure.

Les deux fonctionnent dans cet ordre : les catégories déterminent quels types de produits sont éligibles, et la case à cocher par produit exclut ensuite certains articles parmi ceux qui restent.

Catégories

Dépliez Show the Preview button on these categories dans Settings. Tout est coché au départ. Décochez une catégorie pour retirer le bouton de tout ce type de produit.

Shopify admin: DecorViz: Furniture Visualizer → Settings
Show the Preview button on these categories
▾ Showing on all categories

The Preview button only appears on products DecorViz recognises. Untick a category to hide it there.

Produits individuels

Ouvrez Products dans l'application pour la liste article par article. Chaque produit éligible arrive coché ; décochez la colonne Preview button sur ce que vous voulez écarter. Les changements s'appliquent au chargement de page suivant pour les acheteurs.

Shopify admin: DecorViz: Furniture Visualizer → Products

DecorViz detects suitable products and shows the Preview button automatically. Uncheck Preview button only for items you want to exclude. Categories in Settings still decide which product types are eligible.

Product list

"Published" is the product's Shopify status, not DecorViz. Use the checkbox to include or exclude the Preview button.

Commencez large, puis affinez

Laisser la détection tourner et masquer les quelques articles qui ne conviennent pas est généralement plus rapide que d'essayer d'établir la liste à l'avance. Dans les deux cas, les nouveaux produits sont couverts automatiquement.

Facturation & aperçus

Un aperçu est décompté lorsqu'un acheteur en génère un. Consulter la page produit et ouvrir le widget ne coûtent rien.

  • Free : 5 aperçus d'essai, sans facturation Shopify ni carte bancaire.
  • Storefront 250 : 119 USD par mois pour 250 aperçus. Premier mois 101,15 USD, 15 % de remise.
  • Storefront 500 : 199 USD par mois pour 500 aperçus. Premier mois 169,15 USD, 15 % de remise.

Les forfaits payants se renouvellent chaque mois via Shopify et se résilient depuis votre admin Shopify. Les montées en gamme prennent effet immédiatement et ajoutent une allocation complète à ce qu'il vous reste ; les baisses de gamme prennent effet à la fin de la période de facturation en cours. La remise de bienvenue de 15 % ne s'applique qu'au premier abonnement, pas aux changements de forfait ultérieurs.

Être à court n'est pas une panne

Si l'allocation mensuelle est épuisée, le bouton Preview reste visible, mais l'acheteur qui tente de générer un aperçu voit un message d'indisponibilité temporaire au lieu d'un résultat. Il n'apprend jamais que la boutique est à court. L'application vous avertit quand il reste trois aperçus, puis de nouveau à zéro : surveillez ces bandeaux.

Déjà abonné sur decorviz.ai ?

Installez l'application avec l'adresse e-mail utilisée lors de votre inscription et elle fonctionnera avec votre forfait Storefront existant. L'application affiche la mention « Billed on decorviz.ai » au lieu de vous demander de vous abonner via Shopify, et les aperçus sont décomptés de l'allocation que vous payez déjà. Gérez ce forfait en vous connectant sur decorviz.ai.

Dépannage

Le bouton n'apparaît nulle part

  • Vérifiez que l'app embed DecorViz Storefront est activé dans l'éditeur de thème pour votre thème publié, et non un brouillon ou un thème que vous testiez
  • Vérifiez que votre clé d'installation est bien collée dans le champ Install key de l'embed et que le thème a été enregistré
  • Assurez-vous de consulter l'URL en ligne de votre boutique, pas l'éditeur de thème ni un aperçu de brouillon
  • Vérifiez que « Show the Preview button on my store » est activé dans les Settings de l'application
  • Videz le cache de votre navigateur et rechargez

Le bouton n'apparaît pas sur un produit précis

  • Vérifiez que le produit n'appartient pas à une catégorie exclue dans Settings
  • Vérifiez qu'il n'a pas été masqué individuellement sur la page Products de l'application
  • Si le thème est très personnalisé, définissez un CSS selector dans Settings pour cibler l'élément exact

Le bouton apparaît deux fois

  • Cela signifie que le moteur se charge deux fois. Si vous aviez collé le script DecorViz à la main dans votre thème avant d'installer l'application, retirez cet extrait du thème et ne gardez que l'app embed

Le bouton apparaît mais la génération ne fonctionne pas

  • Vérifiez vos aperçus restants sur la page Billing de l'application. Une fois l'allocation épuisée, le bouton reste affiché mais les acheteurs reçoivent un message d'indisponibilité temporaire au lieu d'un aperçu
  • Vérifiez que votre abonnement est actif. Un forfait résilié ou expiré désactive la génération tout en laissant vos réglages intacts

Bandeau « Registered domain does not match »

  • DecorViz est enregistré pour un domaine différent de celui depuis lequel votre boutique sert désormais les acheteurs, généralement après le passage à un domaine personnalisé. Le bouton n'apparaîtra pas tant que ce n'est pas corrigé. Écrivez à [email protected] avec le domaine de votre boutique et nous ferons le transfert

Bandeau « Shop owner email is missing »

  • Shopify n'a pas transmis d'adresse e-mail de propriétaire pour la boutique, dont DecorViz a besoin pour créer ou associer votre compte. Ajoutez-en une dans votre admin Shopify et rouvrez l'application, ou écrivez à [email protected] avec le domaine de votre boutique

Image produit incorrecte ou absente dans l'aperçu

  • Le moteur récupère l'image produit principale directement sur la page. Vérifiez que cette image se charge normalement pour les acheteurs et qu'elle n'est pas masquée derrière un clic ou une galerie en chargement différé
  • Si votre thème utilise une structure de galerie inhabituelle, contactez le support pour que nous examinions le balisage
Besoin d'aide ?

Contactez notre équipe support à [email protected], ou utilisez la page Support dans l'application.

Questions fréquentes

Dois-je configurer chaque produit séparément ?

Non. L'application détecte les produits éligibles et affiche le bouton Preview automatiquement, y compris pour les produits ajoutés après l'installation. Vous n'ouvrez la page Products que pour masquer le bouton sur certains articles.

Mes acheteurs ont-ils besoin d'un compte DecorViz ?

Non. Les acheteurs utilisent le bouton Preview directement depuis votre page produit. Aucune inscription, aucun téléchargement et aucun paiement à DecorViz.

Puis-je voir les photos de pièce téléversées par les acheteurs ?

Non. Les photos de pièce servent uniquement à générer l'aperçu. Elles ne vous sont accessibles ni via l'application ni via les statistiques produits.

Que se passe-t-il si je change de thème ?

Les app embeds sont enregistrés par thème : un thème nouvellement publié démarre donc avec DecorViz Storefront désactivé. Ouvrez l'éditeur du nouveau thème, activez-le et collez la même clé d'installation. Vos réglages de bouton et vos exclusions de produits sont conservés tels quels.

Cela ralentira-t-il mes pages produits ?

Le moteur se charge de façon asynchrone et ne bloque donc pas le rendu de votre page produit.

Quelles données l'application lit-elle dans ma boutique ?

Uniquement les données produits, et en lecture seule. Elles alimentent la liste des catégories et la liste d'exclusion. L'application n'écrit pas dans vos produits et ne demande aucun accès aux commandes ni aux clients.

Je paie déjà Storefront sur decorviz.ai. Dois-je payer à nouveau ?

Non. Installez avec l'adresse e-mail utilisée lors de votre inscription à DecorViz et l'application fonctionnera avec votre forfait existant, en affichant la mention « Billed on decorviz.ai » plutôt qu'une invitation à vous abonner via Shopify.

Que se passe-t-il si je désinstalle ?

Le bouton Preview cesse d'apparaître et tout abonnement Shopify prend fin avec la désinstallation. Shopify nous envoie ensuite une demande de suppression des données de la boutique, que nous traitons dans les délais fixés par Shopify. Voir la politique de confidentialité pour le détail.

Prêt à commencer ?

Installez l'application, activez l'embed et laissez DecorViz couvrir vos pages produits.