@aglyn/aglyn 1.0.0-beta.253 → 1.0.0-beta.255

package/src/lib/app-utils/docs-index.generated.js

@@ -1297,14 +1297,14 @@ export const DOCS_SECTION_INDEX = [
         title: 'Start a new site with AI',
         heading: 'What gets built',
         anchor: '#what-gets-built',
-        text: 'Plan my site starts the job straight away. A guided start has no plan to approve. It builds, in this order:\n1. A look: a base theme, colors, fonts and the style of buttons, cards and forms, made for your kind of site. See Looks and themes.\n2. A header and footer, as the layout every page sits in, with a link to each page.\n3. A contact form, saved on the Forms page, routed the way you chose, and placed on the page that needs it.\n4. Your first posts or products, on paid plans, when the site is a blog or a store. See A store from the start and A blog from the start. Your first events, when your business holds them and your workspace has the Event Calendar add-on. See Events from the start.\n5. Your pages, each with its sections, its address and its own search title and description. A home page opens with a hero and has several bands below it, such as services, about, social proof and a closing call to action. Photos come from your media library or a stock photo.\n6. A welcome email draft, if you asked for one.\n7. Publishing: see Published, and found by search engines.\nContact details are never made up. A phone number, address or opening hours appear only when you have entered them in your site settings.'
+        text: 'Plan my site starts the job straight away. A guided start has no plan to approve. It builds, in this order:\n1. A look: a base theme, colors, fonts and the style of buttons, cards and forms, made for your kind of site. See Looks and themes.\n2. A header and footer, as the layout every page sits in, with a link to each page.\n3. A contact form, saved on the Forms page, routed the way you chose, and placed on the page that needs it.\n4. Your first posts or products, when the site is a blog or, on paid plans, a store. See A store from the start and A blog from the start. Your first events, when your business holds them and your workspace has the Event Calendar add-on. See Events from the start.\n5. Your pages, each with its sections, its address and its own search title and description. A home page opens with a hero and has several bands below it, such as services, about, social proof and a closing call to action. Photos come from your media library or a stock photo.\n6. A welcome email draft, if you asked for one.\n7. Publishing: see Published, and found by search engines.\nContact details are never made up. A phone number, address or opening hours appear only when you have entered them in your site settings.'
     },
     {
         path: '/ai/start-with-ai',
         title: 'Start a new site with AI',
         heading: 'Building your site',
         anchor: '#building-your-site',
-        text: 'Plan my site takes you to the site\'s Building your site page. It shows one row per step as it happens:\n- Planning your pages\n- Designing your look\n- Building the header and footer\n- Building your contact form\n- Writing your first posts or Adding your first products (a paid blog or store)\n- Writing your pages, then Writing page 2 of 5: About as each page is written\n- Adding your account, cart and policy pages (a paid store)\n- Writing your welcome email\n- Publishing your site\nEach row reads In progress, Waiting, Done, Paused, Not built or Couldn\'t be built, and a finished row shows the credits it used. Credits used so far adds them up. What we\'re building opens the plan: every page and its sections. If one part fails, its row says so and the rest of the site keeps building.\nYou can leave the page: the job keeps going, the notification you get when it finishes opens the page again, and the AI chip in the top bar says what it is doing.\nWhen it is done the page says Your site is live, with the credits the site used, View your site, which opens it in a new tab, and Edit your pages. If some pages were not built, it says how many were and offers Try again what failed, which builds only those.'
+        text: 'Plan my site takes you to the site\'s Building your site page. It shows one row per step as it happens:\n- Planning your pages\n- Designing your look\n- Building the header and footer\n- Building your contact form\n- Writing your first posts (Writing your first post on the Free plan) or Adding your first products (a blog, or a paid store)\n- Writing your pages, then Writing page 2 of 5: About as each page is written\n- Adding your account, cart and policy pages (a paid store)\n- Writing your welcome email\n- Publishing your site\nEach row reads In progress, Waiting, Done, Paused, Not built or Couldn\'t be built, and a finished row shows the credits it used. Credits used so far adds them up. What we\'re building opens the plan: every page and its sections. If one part fails, its row says so and the rest of the site keeps building.\nYou can leave the page: the job keeps going, the notification you get when it finishes opens the page again, and the AI chip in the top bar says what it is doing.\nWhen it is done the page says Your site is live, with the credits the site used, View your site, which opens it in a new tab, and Edit your pages. If some pages were not built, it says how many were and offers Try again what failed, which builds only those.'
     },
     {
         path: '/ai/start-with-ai',
@@ -1346,7 +1346,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Start a new site with AI',
         heading: 'A blog from the start',
         anchor: '#a-blog-from-the-start',
-        text: 'On a paid plan, a site with the Blog & writing style also gets a Blog collection with three posts, signed with the business name and published with the site. Each post has a cover photo, and the blog\'s index page shows the covers on its cards. See Build a blog.'
+        text: 'A site with the Blog & writing style also gets a Blog collection with three posts on a paid plan, or one post on the Free plan, signed with the business name and published with the site. Each post has a cover photo, and the blog\'s index page shows the covers on its cards. See Build a blog.'
     },
     {
         path: '/ai/start-with-ai',
@@ -1360,7 +1360,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Start a new site with AI',
         heading: 'On the Free plan',
         anchor: '#on-the-free-plan',
-        text: 'A Free start builds one or two pages: the home page and the one page your business most needs. It keeps the site within about eight sections in all, uses the same look, header, footer and contact form as a paid start, and drafts no welcome email, posts or products. It spends from the 300 AI credits a Free workspace has each month.'
+        text: 'A Free start builds one or two pages: the home page and the one page your business most needs. It keeps the site within about eight sections in all, uses the same look, header, footer and contact form as a paid start, and drafts no welcome email or products. A blog gets one first post. It spends from the 300 AI credits a Free workspace has each month.'
     },
     {
         path: '/ai/start-with-ai',
@@ -5191,6 +5191,62 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#related',
         text: '- Catalog\n- Shipping'
     },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: '',
+        anchor: '',
+        text: 'Ship with your own Easyship, Sendcloud or ShipperHQ\nRolling out Connecting your own shipping account appears in your console only once it is available on the platform you use. Until then, there is no Your shipping accounts card, and your shipping works exactly as your zones and rates say.\nConnect your own Easyship or Sendcloud account and Aglyn gets rates and buys labels on it instead of on the platform\'s carrier accounts, and that service bills you for each label. Connect ShipperHQ to price checkout shipping with your own ShipperHQ rules.\nEverything else works as described in Shipping labels and live carrier rates: you buy labels from the order, in a batch or from a return, and tracking updates your orders and emails your customers. This page covers what is different.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Before you start',
+        anchor: '#before-you-start',
+        text: '- Your own account at the service. Aglyn has no account with Easyship, Sendcloud or ShipperHQ for you. You sign up with them, and they bill you.\n- Stripe is not needed for labels. Labels on your own Easyship or Sendcloud account are billed to you by that service, so Aglyn charges nothing for them.\n- Who can do it. An admin of the site sees the Your shipping accounts card. To connect or disconnect an account, the admin also needs the workspace\'s Manage billing permission, because it changes how every site in the workspace ships and who bills it.\nThe connection is workspace-wide: every site in the workspace ships through the same accounts.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Connect an account',
+        anchor: '#connect-an-account',
+        text: '1. Open your site\'s Products hub and choose Shipping & delivery. Find the Your shipping accounts card.\n2. Select Connect an account in the card\'s header.\n3. Under Service, pick Easyship, Sendcloud or ShipperHQ, and fill in the fields for it (below).\n4. Select Check and connect. Aglyn checks the credentials with the service before it saves them, and keeps them encrypted. They are never shown again, to you or anyone else.\nThe account then appears on the card with its name at the service, and:\n- Labels and rates for Easyship or Sendcloud, or Checkout rates for ShipperHQ;\n- Test when the account is a sandbox or test one;\n- Tracking not set up when Easyship is connected without a Webhook secret key (see Tracking webhooks).\nA workspace ships through one label platform at a time: while Easyship is connected, Sendcloud isn\'t offered, and the other way round. ShipperHQ can sit beside either.\nEasyship {#easyship}\n- API access token: in Easyship, Connect → API Integration. A sandbox token (it starts with sand) buys test labels, and the account is marked Test.\n- Webhook secret key: optional. The secret key of the Easyship webhook that sends tracking to Aglyn (it starts with webh). See Tracking webhooks.\n- Item category: optional. The Easyship item category your products ship as, used when a product has no HS tariff code.\nEasyship buys from the couriers you have on your Easyship account.\nSendcloud {#sendcloud}\n- Public key and Secret key: in Sendcloud, Settings → Integrations → Sendcloud API. The secret key also signs the tracking updates Sendcloud sends to Aglyn.\nSendcloud buys from the carriers and contracts you switched on in your Sendcloud panel. Sendcloud has no sandbox, so every Sendcloud label is real.\nShipperHQ {#shipperhq}\n- API key: in ShipperHQ, Websites → your website.\n-'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Tracking webhooks',
+        anchor: '#tracking-webhooks',
+        text: 'Easyship and Sendcloud send tracking updates to Aglyn by webhook. Once an account is connected, its row shows a Webhook address to copy.\n- Sendcloud: in Sendcloud, open your API integration, turn on webhook feedback and paste the address. Updates are signed with your secret key, so there is nothing else to enter.\n- Easyship: in Easyship, add a webhook for tracking status changes with the address. Easyship gives the webhook a secret key. Because the key can only be entered when you connect, select Disconnect, then connect Easyship again with the same API access token and the Webhook secret key. The Tracking not set up chip goes away.\nWhen updates arrive, they move your orders exactly as on the platform\'s accounts: the order\'s timeline, the label\'s tracking status, and the Delivered status and email once every parcel has arrived.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'What changes when you ship on your own account',
+        anchor: '#what-changes',
+        text: 'While Easyship or Sendcloud is connected:\n- Shipping labels card: its subheading names your service, and Paying for labels says labels are bought on your own account, which bills you for each one.\n- Carrier accounts card: hidden. Your couriers and carriers are chosen in your account at the service.\n- Services offered at checkout: there is no list to narrow, so checkout offers every service your account quotes.\n- Address checks: not made. Paid orders show no address warnings, and Check address gives no answer.\n- Shipments you record by hand aren\'t followed. Only labels bought through your account get tracking updates.\n- Labels from Sendcloud, and Easyship labels Easyship gives as a file rather than a link, are opened through Aglyn with your account each time you print them.\n- Void cancels the shipment at the service. Easyship answers at once; Sendcloud may show Refund pending first. Any refund comes from the service, not from Aglyn.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Disconnect',
+        anchor: '#disconnect',
+        text: 'Select Disconnect on the account\'s row and confirm.\n- Easyship or Sendcloud: labels already bought stay on their orders, but you can only void them in your account at the service. New labels and rates use the platform\'s carrier accounts when the platform has them; otherwise no new labels can be bought until another account is connected.\n- ShipperHQ: checkout goes back to the carriers\' own rates.\nDisconnecting deletes the credentials from Aglyn.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Troubleshooting',
+        anchor: '#troubleshooting',
+        text: '| The console says | What to do |\n| Enter the field. | Fill in every required field for the service. |\n| Pick a field from the list. | Choose the Scope or Weight unit in ShipperHQ from the list. |\n| The service did not accept those credentials. | Copy the keys again from the service. The service\'s own words may show instead. |\n| ShipperHQ did not accept that API key and authentication code. | Copy both again from Websites → your website in ShipperHQ, and check the Scope. |\n| ShipperHQ could not be reached. | Try again in a few minutes. |\n| This workspace ships through service. Disconnect it first. | One label platform at a time: disconnect the other one first. |\n| That service is not offered on this deployment. | The service isn\'t available to connect yet. |\n| Only a workspace member who manages billing can change this | Ask a member with Manage billing to connect or disconnect. |\n| Not permitted | You need to be an admin of the site. |\n| Tracking not set up on the Easyship row | Add the Webhook address in Easyship, then reconnect with the Webhook secret key (see Tracking webhooks). |\n| Sendcloud parcels never change status | Check that webhook feedback is on in your Sendcloud API integration and that it has the Webhook address from the card. |\n| This label was bought through another shipping account. Void it there. | The label was bought on an account that is no longer the one you ship through. Void it in that account. |\n| This label’s shipping account is no longer connected. | The label\'s file is served through the account you disconnected. Open the label in your account at the service. |'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/ship-with-your-own-easyship-sendcloud-or-shipperhq',
+        title: 'Ship with your own Easyship, Sendcloud or ShipperHQ',
+        heading: 'Related',
+        anchor: '#related',
+        text: '- Shipping labels and live carrier rates\n- Shipping: zones, rates and where each location ships from\n- Use ShippingEasy with Aglyn'
+    },
     {
         path: '/commerce-and-bookings/commerce/shipping',
         title: 'Shipping',
@@ -5219,6 +5275,111 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#where-parcels-ship-from',
         text: 'Each inventory location (the Inventory locations card in the store\'s settings) can carry a postal address: choose Add address on its row, or Edit address once it has one. The address is the street, an optional apartment or suite, city, state or region, postal code, the two-letter country code and a phone number, saved beside the location\'s name.'
     },
+    {
+        path: '/commerce-and-bookings/commerce/shipping',
+        title: 'Shipping',
+        heading: 'Labels and live carrier rates',
+        anchor: '#labels-and-live-carrier-rates',
+        text: 'Buying carrier labels from your orders, live carrier rates at checkout and carrier tracking are rolling out. See Shipping labels and live carrier rates, and Ship with your own Easyship, Sendcloud or ShipperHQ to use an account of your own.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: '',
+        anchor: '',
+        text: 'Shipping labels and live carrier rates\nRolling out Shipping labels, carrier accounts and live carrier rates appear in your console only once they are available on the platform you use. Until then, none of the cards, buttons and fields on this page are shown, there is no Carrier rates rate type, and your shipping works exactly as your zones and rates say.\nBuy postage for an order from the order itself, print the label, and the order is marked shipped with its tracking number. Checkout can also quote each carrier\'s live price for the shopper\'s address, and carrier updates move your orders to delivered.\nThis page covers labels, carrier accounts, live rates and tracking. Zones and rates, and the address each location ships from, are covered in Shipping. To buy labels on your own Easyship or Sendcloud account, or price checkout with ShipperHQ, see Ship with your own Easyship, Sendcloud or ShipperHQ.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Before you start',
+        anchor: '#before-you-start',
+        text: '- A store that ships. The site sells products, and shipping is on for it.\n- A way to pay for labels. Labels on the platform\'s carrier accounts are paid from your store\'s Stripe balance, which needs your Stripe account connected, or on your workspace\'s monthly invoice, which needs a payment method on the Billing page. Labels on a carrier account of your own are billed to you by that carrier. See Paying for labels.\n- Who can do what:\n| Task | Who |\n| See the Shipping labels card, get rates, buy, print and void labels, buy batch and return labels, check addresses | An editor or admin of the site |\n| Save the Shipping labels card, see Paying for labels and the Carrier accounts card | An admin of the site |\n| Turn Stripe balance payments on or off, switch a carrier on or off, connect a carrier account | An admin of the site who also has the workspace\'s Manage billing permission |\n| See the Shipping labels card on Billing → Usage | A workspace member with View billing |'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Set up labels',
+        anchor: '#shipping-labels-settings',
+        text: '1. Open your site\'s Products hub and choose Shipping & delivery. Find the Shipping labels card.\n2. Fill in each section below.\n3. Select Save in the card\'s header.\nThe card\'s subheading names the carrier platform your labels are bought through. When that platform is in test mode, the card says Test mode: labels and rates are samples, and nothing is charged.\nShip from {#ship-from}\nUnder Location, pick one of your store locations, or An address of its own and type the address. A location appears in the list once it has a postal address (see Where parcels ship from).\nLabels and carrier rates need a complete address to ship from: street, city, postal code and country. Until there is one, the card shows a warning.\nBoxes {#boxes}\nList the boxes you ship in: a Name, Length (cm), Width (cm), Height (cm) and Empty weight (g) for each. Tick Default on the box a label starts with. Add a box adds another, up to 20. You can\'t remove the last box.\nThe empty weight is added to the weight of the goods. Checkout also rates a parcel in the default box when the products in it have no packed size.\nLabels {#label-options}\n- Label format: PDF, 4 × 6 in (thermal), PDF, letter paper, or ZPL, 4 × 6 in (Zebra printers).\n- Signature: No signature, Signature required or Adult signature required. It applies to labels and to checkout quotes.\n- Insure each label for the value of what it carries.\n- Customs declarations signed by: the name printed on customs forms for parcels that cross a border.\nServices offered at checkout {#checkout-services}\nTick the carrier services checkout may offer. Leave all unticked to offer every service the carrier quotes. Each shipping rate set to Carrier rates can narrow this further. This list only limits checkout: you can still buy a label for any quoted service from th'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Carrier accounts',
+        anchor: '#carrier-accounts',
+        text: 'The Carrier accounts card, on Products → Shipping & delivery, lists the carriers your labels and checkout rates come from, for every site in the workspace. By default these are the platform\'s carrier accounts, marked Discounted rates. A carrier account you connected is marked Your account. Where a row has a switch, it turns that carrier on or off.\nIf you have your own negotiated carrier account:\n1. Select Connect your own account in the card\'s header.\n2. Pick the Carrier. Which carriers are listed depends on the carrier platform behind your labels.\n3. Fill in what the carrier asks for:\n- UPS and FedEx: the Account number, the Account holder, Company, Email and Phone, and the Billing address on the account.\n- Other carriers, such as DHL Express or Canada Post, ask for the credentials that carrier issued you. They are sent to the carrier platform to connect the account and are not kept by Aglyn.\n4. Select Connect. UPS then asks you to sign in at ups.com to finish. A row that still needs it shows Sign-in needed or Reconnect needed.\nLabels bought on your own carrier account are billed to you by the carrier, so Aglyn charges nothing for them. When you get rates for a label, a rate on your own account is marked Your account.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Product package details',
+        anchor: '#product-shipping-fields',
+        text: 'Physical products have a Shipping section in the product editor:\n- Packed length (cm), Packed width (cm) and Packed height (cm): the product\'s size as packed. A product with no packed size is rated in your default box.\n- HS tariff code: for customs, on parcels that cross a border.\n- Country of origin: where it was made, as two letters, such as US.\nSelect Save product to keep them. Weight is not here: it stays on each variant, where the editor already keeps it, and a label\'s weight is summed from it.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Carrier rates at checkout',
+        anchor: '#carrier-rates-at-checkout',
+        text: '1. Open Products → Shipping & delivery and, on the Shipping card, add a rate to a zone with the Type Carrier rates.\n2. Turn on the services this rate offers, or leave every one off to offer all of them.\n3. Optionally set Markup (%) and Handling fee ($). Both are added to each carrier\'s quote.\n4. Under If no live rate, pick another rate of the same zone. Checkout offers it whenever a live quote isn\'t available.\n5. Select Save shipping settings.\nShoppers then see each carrier\'s service and price for their address, with the delivery estimate in business days when the carrier gives one. Checkout asks for the postal code before it quotes, and the postal code field in the cart and on the product page notes that carrier rates depend on it. While live quotes are offered, the fallback rate is hidden.\nCheckout falls back when no carrier answers within a few seconds, and until labels are ready for your workspace: an address to ship from, and your workspace set up with the carrier platform, which happens the first time someone gets label rates or an admin opens the Carrier accounts card. If live rates aren\'t available on your site, a Carrier rates rate says so and checkout offers the fallback rate.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Address checks',
+        anchor: '#address-checks',
+        text: 'When an order is paid, its shipping address is checked with the carrier. If the carrier can\'t deliver to it, the order shows The carrier cannot deliver to this order’s address. above its labels, with the carrier\'s reason. If the carrier suggests a correction, it shows The carrier suggests a corrected address for this order. Review it under Buy label. Contact your customer before you buy a label.\nTo check again, use Check address in the label dialog (see below).'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Buy a label',
+        anchor: '#buy-a-label',
+        text: '1. Open the order and find Shipping labels. Select Buy label. It is available while something on the order is still to ship and the order has a shipping address.\n2. Select Check address to ask the carrier about the address. If it suggests a correction, Use this buys the label for the corrected address. The order\'s own address stays as your customer gave it.\n3. Under Units in this parcel, set how many of each item go in this box. Everything not yet shipped is filled in. Lower the numbers to split the order across boxes.\n4. Pick the Box, or Another size and enter its length, width and height. Weight (g) is summed from the products and the box: change it to your scale\'s reading.\n5. Select Get rates. Pick a rate. Cheapest, Fastest and Best value are marked, and Your account marks a rate on a carrier account of your own.\n6. Select Buy label.\nThe label opens in a new tab to print. The order records a shipment for those units with the carrier and tracking number, moves to Fulfilled or Partially fulfilled, and your customer gets the shipped email.\nEach label on the order shows its status, service, tracking number, tracking status and cost, with:\n- Print to open it again;\n- Customs invoice for a parcel that crosses a border;\n- Void to cancel a label you won\'t use.\nVoid a label {#void-a-label}\nSelect Void on the label. The label shows Refund pending until the carrier answers, then Voided, or Void refused when the carrier won\'t refund it (for example, outside its void window). When the carrier refunds a voided label, its charge is given back the way it was paid.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Batch labels',
+        anchor: '#batch-labels',
+        text: '1. In the orders list, tick the orders to ship, up to 50, and select Buy labels (n).\n2. Pick the Box and the Service: Cheapest for each order or Fastest for each order.\n3. Select Get rates. Review the service, weight and price for each order. An order that can\'t be rated shows why in place of its service.\n4. Select Buy labels.\nEach order is handled as if you had bought its label on its own: it records a shipment and your customer gets the shipped email. When they are bought:\n- All labels opens one page linking every label;\n- Packing slips prints one slip per parcel, with the address and what goes in the box;\n- Print on each row opens that order\'s label.\nIf a batch is interrupted and you buy again, labels already bought aren\'t bought twice. If a label can\'t be paid for, the batch stops at that order.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Return labels',
+        anchor: '#return-labels',
+        text: 'There are two ways to buy a label from your customer back to your ship-from address.\nFrom a return. Open the return under Products → Returns. While the return is requested or approved and has no label yet, select Buy return label. Choose the Units coming back, the box and a rate, then Buy label. The label is attached to the return. Your customer sees Print your return label on the page where they asked for the return, and later emails about the return include the label link.\nFrom the order. Once something has shipped, the order\'s Shipping labels has Return label. It buys a return label for the shipped units and lists it on the order marked Return. Print it and send it to your customer yourself.\nA return parcel\'s tracking is kept on its label, but it doesn\'t change the order\'s status.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Tracking',
+        anchor: '#tracking',
+        text: 'Every label you buy is followed. So is a shipment you record by hand with a carrier and tracking number, for USPS, UPS, FedEx, DHL Express, Canada Post, Royal Mail and Australia Post.\nEach carrier update is added to the order\'s timeline, and the label shows the latest status: Label created, In transit, Out for delivery, Delivered, Delivery problem or Returned to sender. Updates that arrive late or out of order never move a parcel backward.\nWhen every parcel of a fully shipped order is delivered, the order moves to Delivered and your customer gets the delivered email.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Label spend',
+        anchor: '#label-spend',
+        text: 'Once your workspace has bought a label, Billing → Usage shows a Shipping labels card for this month and the five before it: Labels, From Stripe balance, On invoice, and Voided, returned.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Troubleshooting',
+        anchor: '#troubleshooting',
+        text: '| The console says | What to do |\n| Labels and carrier rates need a complete address to ship from | Under Ship from, pick a location with a full address, or type one: street, city, postal code and country. |\n| Add the address you ship from in Shipping settings first. | The same: set Ship from on the Shipping labels card and select Save. |\n| This order has no complete shipping address. | Add the street, city, postal code and country to the order\'s shipping address. |\n| Orders that are status can’t be shipped. | Only paid and partially fulfilled orders can be shipped. |\n| Everything on this order has shipped. | There is nothing left to ship. Use Return label for a return. |\n| Everything left on this order is being shipped by service / Some of these items are now being shipped by service. Get rates again. | Another fulfillment service holds those items. Ship them there, or get rates again for the rest. |\n| Nothing on this order has shipped yet. | A return label needs units that have shipped. |\n| Those rates have expired. Get rates again. | Select Get rates again, pick a rate and buy. |\n| No carrier quoted this parcel. | Check the box size, weight and address, then get rates again. |\n| No rate matches the service rule. (in a batch) | No carrier quoted that order. Buy its label from the order instead. |\n| This label is already being bought. | Wait a moment, then reopen the order. The label appears once it is bought. |\n| Labels can’t be paid for yet. | Tick the Stripe balance box under Paying for labels, or add a payment method on the Billing page. |\n| The label’s cost will be on your next invoice: reason | The label is bought. Stripe couldn\'t take its cost from your balance, so it goes on your monthly invoice. |\n| The label was bought but the order was not updated: reason. |'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/shipping-labels-and-live-rates',
+        title: 'Shipping labels and live carrier rates',
+        heading: 'Related',
+        anchor: '#related',
+        text: '- Shipping: zones, rates and where each location ships from\n- Ship with your own Easyship, Sendcloud or ShipperHQ\n- Fulfillment, returns and webhooks'
+    },
     {
         path: '/commerce-and-bookings/commerce/store-import-and-export',
         title: 'Import and export store data',
@@ -8885,7 +9046,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Environment variables',
         heading: 'Mobile apps and push',
         anchor: '#mobile',
-        text: 'The native apps (Aglyn and Aglyn POS, for iOS, iPadOS and macOS from apps/ios, and for Android and the Windows desktop from apps/android) are built, not served by your containers. Their settings are build settings, compiled into the app, so changing one means building and shipping the app again. None of them is a secret. On Apple they are xcconfig keys (copy apps/ios/Config/Production.xcconfig.example); on Android and the desktop they are Gradle settings, -Paglyn. =… or the AGLYN environment variable.\n| Apple (xcconfig) | Android (Gradle) | Need | Value |\n| AGLYNCONSOLEURL | consoleUrl | Required | Your console origin. Every API call and console page the app opens is on it, and it is the app\'s universal-link host. Default https://app.aglyn.com. |\n| AGLYNBRANDNAME | — | Optional | The app\'s name and the product name its copy says. Default Aglyn. |\n| AGLYNFIREBASEAPIKEY | firebaseApiKey | Required | The Firebase app config of the app you registered in your project, per bundle. |\n| AGLYNFIREBASEAUTHDOMAIN | firebaseAuthDomain | Required | As above. |\n| AGLYNFIREBASEPROJECTID | firebaseProjectId | Required | As above. |\n| AGLYNFIREBASEAPPID | firebaseAppId | Required | As above. |\n| AGLYNFIREBASEMESSAGINGSENDERID | firebaseMessagingSenderId | Optional | As above. |\n| AGLYNFIREBASESTORAGEBUCKET | — | Optional | As above. |\n| AGLYNGOOGLEIOSCLIENTID, AGLYNGOOGLEWEBCLIENTID | — | Optional | Google sign-in\'s OAuth client ids. The Google button is hidden until both are set. |\n| AGLYNAUTHEMULATORHOST | authEmulatorHost | Development | host:port of a local Auth emulator. Never set in a store build. |\n| AGLYNFIRESTOREEMULATORHOST | firestoreEmulatorHost | Development | host:port of a local Firestore emulator. Never set in a store build. |\nThe server side of push is configured in you'
+        text: 'The native apps (Aglyn and Aglyn POS, for iOS, iPadOS and macOS from apps/ios, and for Android and the Windows desktop from apps/android) are built, not served by your containers. Their settings are build settings, compiled into the app, so changing one means building and shipping the app again. None of them is a secret. On Apple they are xcconfig keys (copy apps/ios/Config/Production.xcconfig.example); on Android and the desktop they are Gradle settings, -Paglyn. =… or the AGLYN environment variable.\n| Apple (xcconfig) | Android (Gradle) | Need | Value |\n| AGLYNCONSOLEURL | consoleUrl | Required | Your console origin. Every API call and console page the app opens is on it, and it is the app\'s universal-link host. Default https://app.aglyn.com. |\n| AGLYNBRANDNAME | — | Optional | The app\'s name and the product name its copy says. Default Aglyn. |\n| AGLYNFIREBASEAPIKEY | firebaseApiKey | Required | The Firebase app config of the app you registered in your project, per bundle. |\n| AGLYNFIREBASEAUTHDOMAIN | firebaseAuthDomain | Required | As above. |\n| AGLYNFIREBASEPROJECTID | firebaseProjectId | Required | As above. |\n| AGLYNFIREBASEAPPID | firebaseAppId | Required | As above. |\n| AGLYNFIREBASEMESSAGINGSENDERID | firebaseMessagingSenderId | Optional | As above. |\n| AGLYNFIREBASESTORAGEBUCKET | — | Optional | As above. |\n| AGLYNGOOGLEIOSCLIENTID, AGLYNGOOGLEWEBCLIENTID | googleWebClientId | Optional | Google sign-in\'s OAuth client ids, used by "Connect Google" on the Account page. On Apple both are needed; on Android only the Web client id, and the Firebase project needs an Android OAuth client for the app\'s package and signing certificate. The action is hidden until they are set. |\n| — | AGLYNGOOGLEDESKTOPCLIENTID, AGLYNGOOGLEDESKTOPCLIENTSECRET | Optional | The Windows a'
     },
     {
         path: '/developers/self-hosting-environment',
@@ -10546,6 +10707,69 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#related',
         text: '- Google Analytics events\n- SEO toolkit\n- Billing & plans'
     },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: '',
+        anchor: '',
+        text: 'Connect Attentive\nRolling out Attentive appears in your console only once it is available on the platform you use. Until then, the Email platforms card has no Attentive row, and the other email platforms work as usual.\nConnect your Attentive account to a site, and Aglyn sends the site\'s contacts and their email marketing consent to it, along with orders and started checkouts that Attentive journeys can start from.\nAttentive works like the other email platforms, with three differences: you connect by signing in to Attentive rather than with an API key, it goes one way only, and there is no list or tag to choose.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Before you start',
+        anchor: '#before-you-start',
+        text: '- Role: you need to be an admin of the site to connect, change or disconnect Attentive. Editors can see the card and the sync log.\n- Verified email: verify your email address first.\n- An Attentive login that can install apps on your Attentive account.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Connect Attentive',
+        anchor: '#connect',
+        text: '1. Open the site, then Setup → Integrations. The Email platforms card lists each platform on a row of its own.\n2. On the Attentive row, select Connect, then Connect with Attentive.\n3. Attentive opens. Sign in and approve the install. Aglyn asks Attentive only to write subscriptions, events and e-commerce events.\n4. Attentive sends you back to the site\'s Integrations page. The Attentive row shows Syncing and your Attentive company name.\nThe first sync starts within 15 minutes. Sync now runs it straight away.\nFinish on Attentive\'s page within 10 minutes. If you cancel there, or take longer, the row shows Connect again: select it, then Connect with Attentive.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'What is sent',
+        anchor: '#what-is-sent',
+        text: '- Contacts and consent go out. Someone the site may send marketing to is subscribed to email marketing in Attentive, by their email address only, when Attentive does not have them yet. Someone Attentive already has is left exactly as Attentive has them. Aglyn never sends a phone number, so nobody is signed up for text messages from here. Someone the site must not market to (they unsubscribed, declined, bounced, complained or were erased) is unsubscribed from email marketing in Attentive. The first sync goes through everyone; after that, only the people whose record changed.\n- Orders go out. For each person the site may market to:\n| In Aglyn | In Attentive |\n| -- | -- |\n| A paid order | A purchase event, with each product, its price and quantity. |\n| A started checkout | A custom event named Started Checkout, with the link back to the checkout when there is one. |\n| A fulfillment | A custom event named Order Fulfilled, with the tracking link when there is one. |\n| A refund | A custom event named Order Refunded. |\n| A cancellation | A custom event named Order Canceled. |\nThe custom events carry the order\'s number, value and currency. An event more than a week old is not sent.\nNames, tags, lifetime value and order counts are not sent to Attentive.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Who is sent',
+        anchor: '#who-is-sent',
+        text: 'Each person is sent with the answer the site\'s own campaigns would give them: subscribed when the site may send them marketing, unsubscribed when they unsubscribed, declined, bounced, complained or were erased. Someone with no consent on record that the site may use is not sent at all: Aglyn does not copy an address it has no standing to market to.\nUnsubscribes in Attentive stay in Attentive {#unsubscribes-stay-in-attentive}\nAttentive does not report unsubscribes back, so Aglyn cannot tell that someone left there:\n- Someone who unsubscribes in Attentive is not unsubscribed from the site\'s own campaigns, and the row\'s count of subscription changes read back stays at zero.\n- Aglyn does not subscribe them again. Because it only subscribes people Attentive does not have yet, a later change to their record on the site, such as a new order, leaves their Attentive subscription as it is.\nTo stop the site\'s own campaigns too, add them to the site\'s unsubscribe list.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Settings',
+        anchor: '#settings',
+        text: 'Once Attentive is connected, its row shows:\n- Sync contacts and unsubscribes: turn off to stop sending contacts and consent while keeping the connection.\n- Send orders and started checkouts: turn off to stop sending events.\n- Pause: stops the sync until you select Resume. Orders that happen while it is paused are not sent later.\nThe row also shows when it last synced and how many contacts and events it has sent.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'The sync log',
+        anchor: '#sync-log',
+        text: 'Select Sync log on the Attentive row to open it. It lists what each run sent and every error, newest first. Each entry is marked Synced, Error or Event not sent.\nThe row\'s status tells you where the connection stands:\n- Syncing: working normally; it runs about every 15 minutes.\n- Paused: you paused it. Select Resume.\n- Stopped: Attentive failed many times in a row (it was retried with growing waits). Fix the cause shown, then select Sync now.\n- Connect again: Attentive refused the connection (the app was removed or its access changed). Select Connect again, then Connect with Attentive. Your settings are kept.\nWhen Attentive asks Aglyn to slow down, the sync waits as long as it was told and carries on. Nothing is lost.'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Troubleshooting',
+        anchor: '#troubleshooting',
+        text: '| You see | What it means, and what to do |\n| -- | -- |\n| No Attentive row on the Email platforms card | Attentive isn\'t available on your workspace yet. See the note at the top of this page. |\n| Email platform connections come with the plans that include the CRM | Your workspace\'s plan doesn\'t include email platform connections. |\n| Not permitted | Only a site admin can connect or change Attentive. |\n| Verify your email address first | Verify your email address, then try again. |\n| Attentive cannot be connected that way here | Attentive isn\'t available to connect right now. |\n| This deployment has no console address to come back to | The connection can\'t be finished from this console. Contact support. |\n| This link is not valid. Start connecting again from the console. | The link back from Attentive was already used or was not one Aglyn started. Start again from the card. |\n| Attentive refused the connection: … | The status changes to Connect again. Connect again. |\n| The stored credential could not be opened. Connect again. | Connect again. |\n| Attentive asked us to slow down | Nothing to do; the sync waits and carries on. |\n| Attentive could not be reached or Attentive had a problem (…) | Retried on its own, waiting longer each time. |\n| Attentive did not take the … event for order …: … | Attentive refused one event, after repeated tries. The rest still go. |\n| Connect again first | The connection needs Connect again before you can pause, resume or sync it. |\n| Resume the connection first | The connection is paused. Select Resume, then Sync now. |\n| Your plan no longer includes marketing platforms, so this connection is not syncing. | The sync picks up again once your workspace\'s plan includes email platform connections. |'
+    },
+    {
+        path: '/marketing-and-automation/email-campaigns/connect-attentive',
+        title: 'Connect Attentive',
+        heading: 'Disconnect',
+        anchor: '#disconnect',
+        text: 'Select Disconnect on the Attentive row and confirm. Aglyn deletes the stored connection, the sync log and any orders not yet sent, and sends nothing more to Attentive. Contacts already in Attentive stay there.'
+    },
     {
         path: '/marketing-and-automation/email-campaigns/deliverability-checks',
         title: 'Deliverability checks',
@@ -10691,7 +10915,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Email platforms (Mailchimp, Klaviyo, Omnisend)',
         heading: 'Connect a platform',
         anchor: '#connect',
-        text: '1. Open the site, then Setup → Integrations. The Email platforms card lists each platform on a row of its own.\n2. On the platform\'s row, select Connect.\n3. Paste your API key, then Check and connect. Aglyn checks the key with the platform before it saves it, and stores it encrypted; it is never shown again.\n- Mailchimp: in Mailchimp, Profile → Extras → API keys → Create a key. It ends in your data center, like -us21.\n- Klaviyo: in Klaviyo, Settings → API keys → Create private API key, with full access to Profiles, Lists, Subscriptions and Events.\n- Omnisend: in Omnisend, Store settings → API keys → Create API key, with access to Contacts and Events.\n4. For Mailchimp and Klaviyo, choose the audience or list contacts go into. If your account has only one, it is chosen for you.\nThe first sync starts within 15 minutes. Sync now runs it straight away.\nOnly a site admin can connect, change or disconnect a platform; editors can see the card and each platform\'s sync log.'
+        text: '1. Open the site, then Setup → Integrations. The Email platforms card lists each platform on a row of its own.\n2. On the platform\'s row, select Connect.\n3. Paste your API key, then Check and connect. Aglyn checks the key with the platform before it saves it, and stores it encrypted; it is never shown again.\n- Mailchimp: in Mailchimp, Profile → Extras → API keys → Create a key. It ends in your data center, like -us21.\n- Klaviyo: in Klaviyo, Settings → API keys → Create private API key, with full access to Profiles, Lists, Subscriptions and Events.\n- Omnisend: in Omnisend, Store settings → API keys → Create API key, with access to Contacts and Events.\n4. For Mailchimp and Klaviyo, choose the audience or list contacts go into. If your account has only one, it is chosen for you.\nThe first sync starts within 15 minutes. Sync now runs it straight away.\nOnly a site admin can connect, change or disconnect a platform; editors can see the card and each platform\'s sync log.\nAttentive connects by signing in to Attentive rather than with an API key, and works one way only: see Connect Attentive.'
     },
     {
         path: '/marketing-and-automation/email-campaigns/email-platforms',
@@ -11533,6 +11757,13 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#security',
         text: 'The Security tab is where you change your password, manage your passkeys and check recent sign-ins. To change your password, type your current one, then the new one twice, and save.\nThe password card appears only if your account has a password. A Google-only account has no password to change — connect Email & password from the Account tab first, and the card appears.'
     },
+    {
+        path: '/workspace-and-billing/manage-account',
+        title: 'Manage Account',
+        heading: 'Close account',
+        anchor: '#close-account',
+        text: 'This is how you delete your Aglyn account. Closing it permanently deletes your personal account — your profile, your sign-in and your place in every workspace — and it takes effect the moment you confirm. There is no waiting period, it cannot be undone, and Aglyn support cannot restore it. Closing your account never deletes a workspace; see What is kept for the rest.\nHow to close your account {#close-account-steps}\n1. Optionally, download your data first. Open the account menu, choose Manage Account, then the Close account tab. The Download my data card sits right above the close card and gives you a machine-readable JSON copy of what Aglyn holds about you: your profile and contact details, your workspace memberships, your passkeys, your public handle and the support messages you wrote. It leaves out your colleagues\' data, and a secret such as an API key is listed as existing, never reproduced. If your last sign-in was more than an hour ago it asks you to sign in again first.\n2. Hand over any workspace you own. If you own a workspace, closing your account is refused until someone else owns it, because otherwise it would be left with nobody who can administer it. Choose Close account and the dialog lists every workspace that still needs an owner, with whether it has an active subscription and how many other members it has. Transfer ownership from Team → Permissions, or delete the workspace if you don\'t need it — a workspace in its deletion hold still counts as yours until the hold ends and it is erased. Being a member, editor, admin or site collaborator never blocks you.\n3. Confirm it\'s you. In the Close your account? dialog, type your password. If you sign in with Google or your company\'s identity provider instead, there is no password box; you are asked to sign in agai'
+    },
     {
         path: '/workspace-and-billing/manage-account',
         title: 'Manage Account',