{"id":420,"date":"2026-09-07T05:03:41","date_gmt":"2026-09-07T05:03:41","guid":{"rendered":"https:\/\/shapekode.com\/product\/optionfroge\/docs\/optionfroge-documentation\/getting-started\/"},"modified":"2026-10-26T11:02:21","modified_gmt":"2026-10-26T11:02:21","slug":"getting-started","status":"publish","type":"docs","link":"https:\/\/shapekode.com\/product\/shapeoptions\/docs\/optionfroge-documentation\/getting-started\/","title":{"rendered":"Getting started"},"content":{"rendered":"\n

Install ShapeOption, then follow the walkthrough below to put a priced option on a product page. No code and no theme changes are needed.<\/p>\n\n\n\n

On this page<\/p>

Requirements<\/span>Install the free plugin<\/span>Install Pro<\/span>Moving from free to Pro<\/span>Your first option group<\/span>The admin menu<\/span><\/p><\/div>\n\n\n\n

Requirements<\/h2>\n\n\n\n
Software<\/th>Minimum version<\/th><\/tr><\/thead>
WordPress<\/td>6.2<\/code><\/td><\/tr>
PHP<\/td>7.4<\/code><\/td><\/tr>
WooCommerce<\/td>8.0<\/code>, installed and active<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Good to know<\/p>

ShapeOption is a WooCommerce extension. If WooCommerce is not active, WordPress will not activate ShapeOption and shows a notice asking you to activate WooCommerce first.<\/div><\/div>\n\n\n\n

Install the free plugin FREE<\/span><\/h2>\n\n\n\n
1<\/div>

Open the plugin installer<\/p>

In your dashboard go to Plugins \u203a<\/span> Add New Plugin<\/span>.<\/div><\/div><\/div>
2<\/div>

Find ShapeOptions<\/p>

Search for ShapeOptions<\/strong>, then click Install Now<\/strong>.<\/div><\/div><\/div>
3<\/div>

Activate<\/p>

Click Activate<\/strong>. A new ShapeOptions<\/strong> menu appears in the admin sidebar and its Dashboard opens.<\/div><\/div><\/div><\/div>\n\n\n\n

Install ShapeOption Pro PRO<\/span><\/h2>\n\n\n\n
1<\/div>

Download the zip<\/p>

Download shapeoption-for-woocommerce.zip<\/code> from your purchase. Do not unzip it.<\/div><\/div><\/div>
2<\/div>

Upload it<\/p>

Go to Plugins \u203a<\/span> Add New Plugin<\/span>, click Upload Plugin<\/strong>, choose the zip file and click Install Now<\/strong>.<\/div><\/div><\/div>
3<\/div>

Activate<\/p>

Click Activate Plugin<\/strong>. The ShapeOption<\/strong> menu appears and the ShapeOption Dashboard opens on the first activation.<\/div><\/div><\/div><\/div>\n\n\n\n
\"WordPress<\/a>
Plugins \u203a Add New Plugin \u203a Upload Plugin.<\/strong> (1) Choose the zip file, then click Install Now.<\/figcaption><\/figure>\n\n\n\n

Tip<\/p>

Pro is a complete, standalone plugin. You can install it on a site that never had the free plugin.<\/div><\/div>\n\n\n\n

Moving from free to Pro<\/h2>\n\n\n\n

The free plugin and Pro keep their option groups apart. Groups you built in the free plugin are not copied into Pro automatically, and an export file from the free plugin cannot be imported into Pro.<\/p>\n\n\n\n

1<\/div>

Install and activate Pro<\/p>

Keep the free plugin active for now, so your products keep showing their options.<\/div><\/div><\/div>
2<\/div>

Rebuild your groups in Pro<\/p>

Create each group again under ShapeOption \u203a<\/span> Add New Option Group<\/span>, or start from a template under ShapeOption \u203a<\/span> Templates<\/span>.<\/div><\/div><\/div>
3<\/div>

Switch off the free plugin<\/p>

Once every group is published in Pro, deactivate and delete ShapeOptions. While both are active, each plugin shows its own groups, so a group that exists in both would appear twice.<\/div><\/div><\/div><\/div>\n\n\n\n

Your first option group<\/h2>\n\n\n\n

This walkthrough adds a paid \u201cGift wrap\u201d checkbox and a free \u201cGift message\u201d box to every product.<\/p>\n\n\n\n

1<\/div>

Start a new group<\/p>

Go to ShapeOption \u203a<\/span> Add New Option Group<\/span>. Type a name at the top, for example Gift options<\/em>. Only you see this name.<\/div><\/div><\/div><\/div>\n\n\n\n
\"A<\/a>
(1) The group name, seen only in the admin. (2) + Add element<\/strong> opens the field picker.<\/figcaption><\/figure>\n\n\n\n
2<\/div>

Add a checkbox<\/p>

Click + Add element<\/strong>, then choose Checkbox<\/strong>.<\/div><\/div><\/div><\/div>\n\n\n\n
\"The<\/a>
(1) Search, or pick a tab to filter the list. (2) Click a field type to add it.<\/figcaption><\/figure>\n\n\n\n
3<\/div>

Set the label and price<\/p>

In the card that opens, set the Label<\/strong> to Add gift wrap<\/em> and the Price<\/strong> to 5<\/em>.<\/div><\/div><\/div><\/div>\n\n\n\n
\"A<\/a>
(1) The label shoppers read. (2) The fee charged when the box is ticked.<\/figcaption><\/figure>\n\n\n\n
4<\/div>

Add a message box<\/p>

Click + Add element<\/strong> again and choose Textarea<\/strong>. Set the label to Gift message<\/em> and the Instructions<\/strong> to We will hand-write it on the card.<\/em><\/div><\/div><\/div><\/div>\n\n\n\n
5<\/div>

Pick the products<\/p>

In the Show on<\/strong> box on the right, keep All products<\/em>, or choose Specific products<\/em>, Product categories<\/em> or Product tags<\/em> and select them.<\/div><\/div><\/div>
6<\/div>

Pick the placement<\/p>

In the Placement<\/strong> box choose Before Add to Cart button<\/em> or After Add to Cart button<\/em>.<\/div><\/div><\/div>
7<\/div>

Publish<\/p>

Click Publish<\/strong>. The group is now live \u2014 its status shows Live<\/em> in the group list.<\/div><\/div><\/div><\/div>\n\n\n\n
\"The<\/a>
(1) Show on<\/strong> \u2014 which products get the group. (2) Placement<\/strong> \u2014 before or after Add to Cart. (3) Publish<\/strong> puts it live.<\/figcaption><\/figure>\n\n\n\n
8<\/div>

Check the product page<\/p>

Open any product. The two fields appear next to the Add to Cart button. Tick the checkbox and the total line updates, for example Total: $25.00 (Options: $5.00)<\/em>.<\/div><\/div><\/div><\/div>\n\n\n\n
\"Option<\/a>
Option fields on a product page. (1) The total updates live as shoppers choose: product price plus options.<\/figcaption><\/figure>\n\n\n\n

Tip<\/p>

Want a head start? ShapeOption \u203a<\/span> Templates<\/span> has ready-made groups such as gift wrap, personalization and delivery preferences. Installing one creates a draft you can adjust and publish.<\/div><\/div>\n\n\n\n

The admin menu<\/h2>\n\n\n\n
Menu item<\/th>What you do there<\/th>Plan<\/th><\/tr><\/thead>
Dashboard<\/strong><\/td>Counts of live and draft groups, fields, priced and conditional fields, and your latest groups.<\/td>FREE<\/span><\/td><\/tr>
All Groups<\/strong><\/td>Every option group with its status, fields, products, placement and shortcode.<\/td>FREE<\/span><\/td><\/tr>
Add New Option Group<\/strong><\/td>Opens the builder for a new group.<\/td>FREE<\/span><\/td><\/tr>
Templates<\/strong><\/td>Ready-made groups to install as drafts.<\/td>FREE<\/span><\/td><\/tr>
Style Settings<\/strong><\/td>Size, corner shape and accent color of the fields on your store.<\/td>FREE<\/span><\/td><\/tr>
Analytics<\/strong><\/td>Which options shoppers pick and how much they add to revenue.<\/td>PRO<\/span><\/td><\/tr>
Import \/ Export<\/strong><\/td>Move option groups between sites as a JSON file.<\/td>FREE<\/span><\/td><\/tr>
Uploads (S3)<\/strong><\/td>Send customer uploads to Amazon S3 or another S3-compatible storage.<\/td>PRO<\/span><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"The<\/a>
The ShapeOption<\/strong> menu (outlined) and its Dashboard: group counts, recent groups with their shortcodes, and quick actions.<\/figcaption><\/figure>\n\n\n\n

In the free plugin the menu is called ShapeOptions<\/strong>; in Pro it is called ShapeOption<\/strong>. The paths in these guides use the Pro name.<\/p>\n\n\n","protected":false},"featured_media":0,"parent":418,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"nav_title":"","positive":"","negative":"","footnotes":""},"docs_category":[],"class_list":["post-420","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/comments?post=420"}],"version-history":[{"count":8,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/420\/revisions"}],"predecessor-version":[{"id":599,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/420\/revisions\/599"}],"up":[{"embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/418"}],"wp:attachment":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/media?parent=420"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs_category?post=420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}