Frequently asked questions
30+ answers for site owners and developers. Each answer links to docs where relevant.
What is Instaflax?
A WordPress plugin that displays Instagram feeds on your site using OAuth and the Instagram Graph API. Connect accounts, customize in the Feed Customizer, and embed with shortcodes.
What WordPress version is required?
WordPress 6.0 or newer.
What PHP version is required?
PHP 7.4 or newer.
Is there a free plan?
Yes. Starter is free (GPL plugin) with Grid & Carousel, 1 site, 1 account, 1 feed, up to 20 posts. Pro ($19/year) and Business ($29/year) unlock more layouts, posts, and accounts.
Do I need a Facebook / Meta Developer app?
Yes. Instagram Graph API access requires a Meta Developer app with the Instagram product. You set your App ID in the plugin or wp-config. See our Meta app setup guide.
Do I need a Business or Creator Instagram account?
Yes. The Instagram Graph API works with professional (Business or Creator) accounts linked to a Facebook Page.
Why OAuth instead of embedding widgets?
OAuth lets you use the official Graph API with secure, encrypted long-lived tokens—better performance, compliance with Meta terms, and full control over layout and caching.
Where are tokens stored?
Long-lived tokens are stored encrypted in your WordPress database. They are never placed in redirect URLs or front-end output.
Is the App Secret in the plugin?
No. Token exchange uses a hosted proxy at one.mahihub.in so your App Secret stays off the customer server.
How do I install the plugin?
Upload to wp-content/plugins, activate, save permalinks once, then connect Instagram from the Dashboard.
Does it work on WordPress Multisite?
Each site activates and licenses separately. Plan limits apply per site URL.
How many feeds can I create?
Starter: 1 feed. Pro: 3 feeds. Business: unlimited.
How do I embed a feed?
Use [insta-feed id="1"] (recommended) or the legacy [scf_instagram_feed] shortcode.
What is the difference between layouts?
Grid and Carousel are on Starter. Masonry and Highlight require Pro or Business.
Why are some Customizer options locked?
Those features require a higher plan. Upgrade to Pro or Business and activate your license under Settings → License & Plan.
Should preview match the live site?
Yes. The Feed Customizer preview is designed to match the front-end output. If they differ, clear cache and check the same feed ID.
Is the license per site?
Yes. License validation sends your site URL and license key to the license API.
Can I transfer a license?
Deactivate on the old site first, then activate on the new site. Contact support if you hit activation limits.
What happens when my license expires?
Pro/Business features are gated. Your feeds keep working on Starter limits until you renew and reactivate.
What payment methods are accepted?
Checkout uses Razorpay via the [scf_checkout] shortcode on mahihub.in or your checkout page.
Can I get a refund?
See our Refund Policy. Request within the stated window with order details.
Do you provide invoices?
Receipts are sent by Razorpay/email after purchase. Contact billing for invoice requests.
How does token refresh work?
WP-Cron refreshes long-lived tokens about every 30 days automatically.
How long is the API cached?
Transient API cache reduces Graph API calls. Business plans can control per-feed cache settings.
Are there API rate limits?
Yes—Meta enforces Graph API rate limits. Caching and reasonable post counts help stay within limits.
How do I debug OAuth issues?
Enable WordPress debug logging and look for [SCF OAuth] entries. Verify redirect URI and App ID.
Does it work with Elementor?
Yes—paste the shortcode in a Shortcode widget or HTML block.
Does it work with page builders?
Any builder that supports shortcodes (Elementor, Gutenberg, Divi, etc.) works.
Compatible with caching plugins?
Yes. Exclude admin/AJAX if needed; clear page cache after feed changes.
Does CDN affect feeds?
Front-end assets load normally; ensure HTML pages with shortcodes are not over-cached with stale feed HTML if you use full-page cache.
Still stuck? Visit Help or contact support.