Before you start

1. Sign in with GitHub and install the feedback2code GitHub App. Choose the repository that holds the code of the site.
2. Open the repository in the dashboard, go to Configure and add the domains the widget may run on.
3. Copy the snippet from Embed Widget. It contains your widget ID.

Add the widget

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script(
        'feedback2code',
        'https://www.feedback2code.dev/widget/YOUR_WIDGET_ID',
        array(),
        null,
        array(
            'strategy'  => 'async',
            'in_footer' => true,
        )
    );
} );

Replace YOUR_WIDGET_ID with the ID from your dashboard. The strategy argument needs WordPress 6.3 or newer. On older versions, pass true as the last argument to load the script in the footer.

What the agent can change

The agent changes what is in the repository: theme templates, CSS, JavaScript, block patterns and plugin code. Posts, pages and settings live in the WordPress database and are outside its reach.

Every change arrives as a pull request. Nothing is merged or deployed until you do it, so your usual review and deployment stay as they are.

Good to know

• This setup fits custom themes and plugins under version control. A site built only in the admin area has no repository for the agent to work on.
• Requests about content, such as “change the opening hours”, are for the editor, not for the agent. Requests about layout and behaviour are a good fit.
• With a Content-Security-Policy, allow https://www.feedback2code.dev in script-src and frame-src.
• How a merged pull request reaches the server depends on your deployment. The agent stops at the pull request.

Test it

1. Deploy the change and open the site on an authorized domain.
2. Click the button at the bottom right and send one small, concrete request.
3. Open your dashboard. The submission starts as coding and turns to awaiting review once the pull request is open.

What a submission contains and how the plans differ is described on the page about the website feedback widget.

Other setups

• Feedback widget for Next.js
• Feedback widget for React apps
• Feedback widget for Vue and Nuxt
• Feedback widget for Astro
• Feedback widget for static HTML sites
• Feedback widget for Shopify themes

Questions and answers