Using FBML in an iFrame page

Oct 14, 2008 at 9:30 PM
I have been wracking my brain trying to figure out how to put a "Share" button on an iFrame page. I've read that you can't simply insert FBML into an iFrame page so I created an iFrame on that page and tried loading an FBML page with the Share button. It works but loads the entire Facebook chrome into that iFrame so it's not a workable solution. I also can't just convert my page to FBML b/c it uses lots of ASP tags and other functionality so it's not feasible to make the entire page FBML. Any help greatly appreciated!
Oct 15, 2008 at 8:38 PM
I have finally figured it out. It is always tough to write these, because sometimes Facebook changes things pretty quickly and if you are reading this 5 days after I wrote it, not everything may still be true, but here it goes.

You are correct about how the share button fbml works right now, unless you do it the way I do it.

Step 1. Your page should have this at the top
<html xmlns="" xmlns:fb="" >

Step 2. reference the facebook stylesheet
<link rel="stylesheet" href="" type="text/css" />

Step 3. In the body put this
<script src="" type="text/javascript"></script>

Step 4. The next steps can go in any order as you see fit.

Put some FBML. One key thing to note is that if your not using XFBML you have to wrap it in fb:serverfbml

<fb:serverfbml style="width: 715px;">

        <script type="text/fbml">
          <fb:tab-item href='' title='Home' selected='true'/>
  <fb:tab-item href='' title='Survey Results' />
  <fb:tab-item href='' title='My Favorites' />
  <fb:tab-item href='' title='Invite Friends' />
  <fb:tab-item href='' title='FAQ' />


<div class="ExSmall">
        <fb:serverfbml style="width: 700px; background-color: #ffffe0;">

            <script type="text/fbml">
                <fb:if-section-not-added section="profile">   
                <h3>Add to profile:</h3>
                You have not added this
                application to your profile. By clicking this button, you will be given an option
                adding this to your profile. If you would like to show your friends what your car soulmate
                is, we suggest selecting the button. For more information on what these means,
                see the <a href="" target="_blank">frequently asked

    <div align="center">
        <div id="addSection" align="center">

Step 5. To get the profile button you notice the addSection div tag in bold above. Under this tag put the following
<script type="text/javascript">
    window.onload = function() {
    FB_RequireFeatures(["Integration"], function() {
        // Change the first arg to your api key, and the second to the path to your receiver.html file.
        FB.Facebook.init('<%=ConfigurationManager.AppSettings["applicationCode"].ToString() %>','xd_receiver.htm', null);

        // These two lines add a "add to profile" button under the given id.
        FB.Integration.showAddSectionButton("profile", document.getElementById("addSection"));      


Step 6. at the very bottom of the page, right before the close body tag
<script type="text/javascript">
    FB_RequireFeatures(["XFBML"], function(){
        FB.Facebook.init('<%=ConfigurationManager.AppSettings["applicationCode"].ToString() %>', "xd_receiver.htm");

Step 7. If you want to add smart resizing add this after the previous entry

<script type="text/javascript">
FB_RequireFeatures("CanvasUtil", function(){
//FB.XdComm.Server.init('/xd_receiver.htm'); // must have "/" before the html file
FB.Facebook.init('<%=FACEBOOK_API_KEY %>', '/xd_receiver.htm', null);


Hope that helps people. The only weird thing I can't seem to solve is that the page jumps around before it shows the fbml. You can see what I mean if you try my application at
Oct 15, 2008 at 8:44 PM
thanks for sharing this!!!
Oct 15, 2008 at 10:16 PM
Thanks, it worked like a charm! Now I have a "Share" button on my iFrame page but when clicked it pushes the content below it down as the Share dialog displays. I was hoping it would act as an overlay like the profile button does. Do you know if that's possible?
Oct 16, 2008 at 12:16 PM
Edited Oct 16, 2008 at 12:18 PM
Thanks man!  That's exactly what I needed to get me started... seems like we can't rely on the toolkit any more so we have to do some dodgy semi-hooked in stuff.

I had to do it slightly differently though (NFI why!)... I had the same <script> include and CSS (had a conflict with the H2 tag in my css but that's all sorted) but this is what works for me:

FB_RequireFeatures(["XFBML"], function(){
    FB.Facebook.init('<%=ConfigurationManager.AppSettings["APIKey"].ToString() %>','xd_receiver.htm', null);
    FB.Connect.showAddSectionButton("profile", document.getElementById("addProfileButton"));

The auto-resize iframe thing is FINALLY working too.  I spent ages on that when they first released it to no avail.  Your code worked a treat. ;)  For those of you who aren't aware you have to set your application to not smart resize in the App Settings for this to work.  Finally those schmuck users in 800x600 won't have double scroll bars. JOY!

Now to get the MultiFeedStory happening:
Nov 17, 2008 at 2:20 PM
Great work!! Thank you very much.
I can see the button now, but I think it doesn't work; I mean it doesn't add anything on the profile... and when I want to edit an application I can't see any link to get the application on the profile...
Do you know why?
Thank you
Nov 17, 2008 at 9:15 PM
Ok now that I succeeded to create the xd_receive.htm page, there is a window asking me to allow the application on my profile... but I can't see it...! Do I need to have a page in my asp project for the profile box? I mean I already programmed the page, but do I have to specify any URL to facebook or something like that?
Thank you
Dec 15, 2008 at 1:57 PM
The code posted by Cargango above worked for me a couple of months ago but not now. Does anyone know if something has changed on the Facebook side?
Dec 17, 2008 at 1:34 AM
I've just tried the <fb:serverfbml> code above in the xfbml test app and they seem to work fine there.

The stylesheet does not seem to exist anymore.
Jan 27, 2009 at 11:26 AM
i have follow the all the steps to render the xfbml for my iframe based application.
but it seems like not rendring.
For example :
i m adding this tag on my aspx page:



fb:prompt-permission perms="email"> Grant permission for email </fb:prompt-permission>

tag for prompting email popup.but it is just showing  simple text "Grant permission for email " and not prompting any popup.
its not becoming hyperlink.

---when i chk the session using is coming null..but the user is login .

any help


Mar 10, 2009 at 6:37 PM
Does this method still work.  I followed the directions above but nothing rendered....  Has anyone used this lately?
Mar 11, 2009 at 1:07 PM
This method not working for me too!

Mar 13, 2009 at 6:55 AM
same doesn't render fbml code unless n until i use fb_force_mode=fbml with the url
Apr 7, 2009 at 9:30 AM
This should not be another "here too", but still it is part of my message.

My facebook code part of an iFrame app, *not* using IframeMasterPage, since I had to use our internal MasterPage (all other faceoobk stuff inside the iFrame works, such as userid, friendlist, profiledata reading):

<script src="" type="text/javascript"></script>
<fb:serverfbml style="width: 755px;">
<script type="text/fbml">
<fb:request-form action="" method="POST" invite="true" type="XFBML" content="Your friend is inviting you to use the following app" >
<fb:multi-friend-selector showborder="false" actiontext="Select friends to invite:"></fb:multi-friend-selector>
<script type="text/javascript">
FB_RequireFeatures(["XFBML"], function()
FB.Facebook.init("MYAPIKEY", "xd_receiver.htm");

This just does not render. I have the proposed and needed <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="" xmlns:fb=""> included. Testing on the above link works perfect.

If I trace a call to the page containing this code with fiddler, I see a "bad request" answer for a call to login_status.php at I do not know why it fails / gets a bad request, since all other facebook stuff works, I can read out the cookie and request parameters. Only part, I have no clue how I could generate a session, since I do not get an auth token (user must be logged in already before coming to the iFrame app, otherwise he gets a "page not found" nor the "Session["Facebook_session_key"]" Session information. Only things like "Request.QueryString["fb_sig_session_key"]" and cookie work. The fiddler terse summary:

400 Bad Request:

And yes, I have replaced MYAPIKEY in all posted parts. They appear instead of the text. Just don't want to give away too much.

Would be nice to hear from somebody knowing a solution. Im cobbling for a whole week now, this is fading my motivation away...

Cheers, ChrisTar

Apr 15, 2009 at 5:20 PM
Edited Apr 15, 2009 at 5:54 PM

You need to set the Connect Url to your application settings page in FB in order to fix the issue you are having unless you have already figured it out.

good luck

Apr 16, 2009 at 8:04 AM

Thanks, this indeed solved the problem. Even if I see only half of the point... XFBML was for me not a connect feature, since it can be used for iFrame Apps on facebook itself. But true, the URL leading to the 400 Error could have told me other...

Thanks for the advice,

Cheers, ChrisTar
Jun 23, 2009 at 8:41 PM
Edited Jun 23, 2009 at 9:22 PM