Getting started
Update Faubourg
Install a new version of the theme without losing your settings.
On this page
Faubourg updates fix issues, keep up with changes to Shopify, and add features. They're described in the release notes.
Find your version
In the theme editor, open the … menu at the top right. The theme's name and version are at the bottom of the menu, under the links to this documentation (View documentation) and to support (Get support). The version also appears next to the theme name in Online StoreThemes.
This documentation covers Faubourg 1.1.0.
Theme installed from the Theme Store
When a new version is available, a notice replaces the version number next to Faubourg in Online StoreThemes.
Read the release notes
Click the notice, then View release notes. Check what's changing, especially if it affects a section you use.
Add the update to your draft themes
In the same dialog, click Add to draft themes. Shopify adds a new copy of the theme under Draft themes, named "Updated copy of…". Your published theme isn't changed.
Check the new version
Preview and customize the updated copy: home page, product, collection, cart, search. If you had code changes, check the pages they affect first.
Publish
Publish the updated copy. The old version stays under Draft themes in case you need to switch back.
What the update keeps
Shopify carries over to the new copy:
- your theme settings;
- your page layouts: sections and blocks added, reordered, hidden or removed;
- the settings and content of your sections and blocks (text, images, videos, collections…);
- the wording you changed with Edit default theme content;
- your app embeds and app blocks, with their settings.
Code changes (Liquid, CSS, JavaScript), whether you or an app made them, are included when they don't conflict with the new version. The theme card tells you which: "code edits successfully included" or "code edits could not be included".
Theme installed from a .zip file
Shopify only updates themes installed from the Theme Store: a theme you uploaded yourself doesn't receive updates. A Faubourg license belongs to the store it was bought for; a copy uploaded to another store is unlicensed and must be bought from the Theme Store for that store to receive updates.
To move a .zip copy to a new version anyway, rebuild your customizations in the new version rather than copying files into it. Compare the two versions side by side and carry over only what you changed.
Duplicate your current theme
Open the … menu and choose Duplicate to keep a backup.
Upload the new version
Online StoreThemesImportUpload zip file. The new version starts with its default settings and pages.
List what you changed
Open the old theme in the editor and note what differs from the defaults: your theme settings (fonts, colors, layout…), the sections and blocks you added, moved or hid on each page, and your section groups: header, footer, the pop-up in Overlays, and Policy pages. The release notes tell you which settings, sections or blocks were renamed or removed.
Carry over your settings and sections
In the new version's editor, set the same theme settings, then rebuild each page: add your sections and blocks, and fill in their content. Where a section or block was renamed or removed, use its replacement.
Reapply your code changes
Reapply only your own changes, one by one, in the new version's files. Never replace a whole file with the old version's.
Check, then publish
Preview every page you use in the new version's editor before publishing it.
Faubourg 1.1.0