For the complete documentation index, see llms.txt. This page is also available as Markdown.

Shortcodes

Display a storefront anywhere with the [affegg] shortcode. The storefront's id is the only thing it needs:

[affegg id=10]

You'll find the shortcode on the storefront's screen, and there's an Add storefront button in the post editor that inserts it for you. You can also skip shortcodes entirely and use the Affiliate Egg Storefront block — see Creating a storefront.

Options

Attribute
What it does
Example

id

The storefront to display (required).

[affegg id=10]

limit

Show at most this many products.

[affegg id=10 limit=3]

offset

Skip the first N products.

[affegg id=10 offset=5 limit=3]

next

Show the next N products — repeat to spread a storefront down a post.

[affegg id=10 next=3]

random

Show N random products.

[affegg id=10 random=3]

order

Sort by a field, optionally reversed.

[affegg id=10 order="price desc"]

template

Use a specific template instead of the default (see Templates).

[affegg id=10 template=cards]

hide

Hide one or more fields.

[affegg id=10 hide="description,domain"]

btn_text

Custom button text (supports placeholders — see below).

[affegg id=10 btn_text="Buy at %MERCHANT%"]

Splitting a storefront with next

next lets you place a storefront's products at different points in an article. This shows the first 3:

[affegg id=10 next=3]

Add the same shortcode again lower in the post and it shows the next 3, and so on.

Sorting with order

Sort by any of these fields: title, price, manufacturer, in_stock, create_date, last_update, last_in_stock, shop_id.

Add desc for reverse order, or use rand for a random order:

Hiding fields with hide

Hide one or more fields from the output — handy for a cleaner or more compact block. Pass a comma-separated list:

Fields you can hide: description, price, oldprice, rating, brand, stock, domain, updated, disclaimer.

Custom button text with btn_text

Override the button text for a single block. You can include placeholders that fill in per product:

  • %MERCHANT% — the merchant / shop name

  • %DOMAIN% — the shop's domain

  • %PRICE% — the product's price

To change the button text everywhere at once instead, use the setting in Frontend text & wording.

Last updated